Guardian C Library Calls Reference Manual

Reference to Library Calls
Guardian TNS C Library Calls Reference Manual—128833 3-75
get_assign_msg_by_ name (supplementary)
•
For portability, programs can specify logical units, such as TAPEFILE or PRINTER,
instead of the names of actual files or devices. The TACL ASSIGN command, or the
#ASSIGN built-in variable, associates a specific file or device with a given logical
unit to represent that actual entity when you run the program
In the type assign_msg_type, the structure members provide the following
information:
msg_code
value of -2 for an ASSIGN message
logical_unit_name
name of logical unit used in program and consists of
program unit and file name
field_mask
bit mask that indicates which of the following fields
were supplied (1 = supplied):
.<0> = physical file name
.<1> = primary extent size
.<2> = secondary extent size
.<3> = file code
.<4> = exclusion size
.<5> = access specifier
.<6> = record size
.<7> = block size
filename
physical file name to be associated with logical unit
primary_extent
primary extent size
secondary_extent
secondary extent size
file_code
file-code
exclusion_spec
exclusion mode:
%00 if SHARED
%20 if EXCLUSIVE
%60 if PROTECTED
access_spec
access mode:
%0000 if read/write
%2000 if read only
%4000 if write only
record_size
record size
block_size
block size