- 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. Refer to appendix A
for meanings of status values.
- buffer
character array by reference (required)
An array containing all of the information necessary to duplicate a KSAM/XL file.
The information including the KSAM/XL control block was obtained from an
AIFKSMREAD. It is used by AIFKSMCREATE to create a KSAM/XL file.
The information includes the file label, file label extension, the KSAM/XL
control block, and a HFS pathname for files in the hierarchical directory.
The minimum buffer size is 10,240 bytes.
- bytes
32-bit signed integer by value (required)
An integer specifying the length of the information in the buffer.
- 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.
- group_name
Character array by reference (optional)
Specifies an existing group where the KSAM/XL file will be created. If this
parameter is not provided, the default group is where the KSAM/XL file being
read resides.
Array type: mpe_name_type (Refer to appendix B.)
- acct_name
Character array by reference (optional)
Specifies an existing account where the KSAM/XL file will be created. If this
parameter is not provided, the default account is where the existing KSAM/XL
file resides.
Array type: mpe_name_type (Refer to appendix B.)
- creator
Character array by reference (optional)
Specifies the creator of the file being created. If this parameter is not
provided, the creator in the file label of the existing KSAM/XL file
is used.
Note that with the introduction of the hierarchical file system, the creator
concept has been replaced with the concept of the file owner, which
includes both the user and account name;
therefore, the format of this parameter has
changed to USER.ACCOUNT (padded with blanks). The name is also not
upshifted.
Array type: mpe_name_type (Refer to appendix B.)
- old_date
Boolean by value (optional)
By specifying the old_date to be true, the original modification and last
access dates in the file label are retained. Default is false.
- ldev_num
Short integer by reference (optional)
Specifies the logical device number where the KSAM/XL file will be created.
- vol_class
Character array by reference (optional)
Specifies a volume class name on which the KSAM/XL file will be created.
Array type: t_vol_class_name (Refer to appendix B.)
- vol_name
Character array by reference (optional)
Specifies the volume class on which the KSAM/XL file will be created.
Array type: t_volume_name (Refer to appendix B.)
- vol_set_name
Character array by reference (optional)
Specifies the volume set on which the KSAM/XL file will be created.
Array type: t_vol_set_name (Refer to appendix B.)
- directory
record by reference (optional)
Passes the absolute pathname of the directory where the KSAM/XL file will
be created. If this parameter is specified, then the group_name and
acct_name parameters will be ignored. An example of a valid
pathname for this parameter is /SYSUTIL/MPEXL/tools_directory/.
Record type : pathname_type (Refer to appendix B).
- file_name
record by reference (optional)
Passes the new name of the KSAM/XL file to be created. If this name is
specified along with group_name and acct_name, then
the file is created in the MPE domain. If directory is specified then
a POSIX file is created. A directory option overrides the
group_name and acct_name.
If file_name is specified and neither directory, nor
group_name and acct_name are specified, then the file
is created in the same domain as the original file with a new name.
Record type: pathname_type (Refer to appendix B)