- overall_status
record by reference (required)
Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not specific to any particular item. A positive value indicates the last element in itemstatus_array, signaling an error condition. Refer to appendix A for meanings of status values.
Record type: status_type (Refer to appendix B.)
- itemnum_array
32-bit signed integer array by reference (required)
An array of integers where each element is an item number indicating the operating system information to be modified. New information must be located in a data structure pointed to by the corresponding element in item_array. If n item numbers are being requested, element n+1 must be a zero to indicate the end of the element list.
- item_array
64-bit address array by reference (required)
An array where each element is a 64-bit address pointing to a data structure containing new information to be passed to the operating system. Information and its required data type are defined by the item number passed in the corresponding element in itemnum_array.
Array type: globalanyptr
- itemstatus_array
record array by reference (required)
An array where each element returns the status of the operation performed in the corresponding element in item_array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values.
Array type: status_type (Refer to appendix B.)
- UFID
record by reference (optional)
Required if filename is omitted. Passes the UFID of the file whose information is to be modified. Use this parameter if performance is a concern.
Note that this parameter is not adequate for identifying the pathname for
an HFS syntax file.
You should specify path_identifier instead of this item when you are
interested in both MPE syntax and HFS syntax files.
Record type: ufid_type (Refer to appendix B.)
Default: nil
- filename
record by reference (optional)
Passes the fully qualified name of the file for which information is desired. The name in each element of the record filename_type must be left-justified and padded with blanks. In addition, characters must be in the correct case
(uppercase and/or lowercase).
If the UFID is omitted and you are interested only in those files
that can be represented by MPE syntax, this parameter is required.
For HFS syntax files, the pathname parameter should be specified.
Record type: filename_type (Refer to appendix B.)
Default: nil
- tempfile
Boolean by value (optional)
Indicates whether or not the file specified is a temporary file. If true, the file is a temporary file. If false, or if this parameter is omitted, the file is a permanent file.
Default: false
- user_id
32-bit signed integer by value (optional)
The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
If it is not passed, the caller must have previously called
AIFACCESSON.
Default: 0
- ver_item_nums
32-bit signed integer array by reference (optional)
An array of integers where each element is an item number indicating the operating system information to be verified before proceeding with modification. Verification information must be located in a data structure pointed to by the corresponding element in ver_items. If n items are being verified, element n+1 must be a zero to indicate the end of the item list.
Default: nil
- ver_items
64-bit address array by reference (optional)
An array where each element is a 64-bit address pointing to a data structure containing information to be verified against current operating system information. Information and its required data type are defined by the item number passed in the corresponding element in ver_item_nums.
Array type: globalanyptr
Default: nil
- ver_item_statuses
record array by reference (optional)
An array where each element returns the status of the verification performed in the corresponding element in ver_items. A zero indicates a successful verification. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values.
Array type: status_type (Refer to appendix B.)
Default: nil
- path_identifier
record by reference (optional)
Passes the unique path_identifier of the MPE syntax or HFS syntax file for
which information is desired. Use this parameter if performance is a concern
and you are interested in either an MPE syntax or HFS syntax file. Note that
when specifying this parameter, you must specify item 5036 to get the
corresponding pathname for an HFS syntax file (for example, /SYS/PUB/dirc/pxfile).
Record type: path_identifier (Refer to appendix B.)
Default: nil
- pathname
record by reference (optional)
Passes the pathname of the file (MPE syntax or HFS syntax) for which information
is desired. If path_identifier is omitted and you are interested in
both MPE syntax and HFS syntax files, then this parameter is required.
If you specify both this parameter and the filename parameter, then the
filename parameter is ignored.
The first word in the pathname specifies the length of the name.
Record type : pathname_type (Refer to appendix B.)