ONXCOPY Copying Files / Lib. Elements / Job vars.

ONXCOPY ['str1'=... [, vsn/device | :x: [,smspar] ] ] [, STD] ]

'str1'= ... Name Transformation Rules

'str1'='str2' | 'str1'=DP[n][I] | 'str1'=DS[n][I]

'str1'='str2'

The name of the copied data object is constructed by searching the original name for the string 'str1' and by replacing it with 'str2'. By default, the empty string '_' will appear at the end of every name, and the null string '' at the beginning.

'str1'=DP[n][I]

Delete Prefix: The name of the new data object will be constructed by searching the original name for the string 'str1' and deleting all, or n characters to the left. Specifying the I option will cause 'str1' to be deleted as well.

'str1'=DS[n][I]

Delete Suffix: The name of the new data object will be constructed by searching the original name for the string 'str1' and deleting all, or n following characters. Specifying the I option will cause 'str1' to be deleted as well. For further information, see page 5-.

vsn/device The copied files are created on the specified private volume.

:x: The copied files are created on the specified PVS.

smspar If the copied file is to be created on an SM pubset (System Managed pubset), this parameter, in conjunction with the associated system administrator default values, can be used to determine the storage location (Volume set) of the file.

If the prefix :x: is not specified before smspar, then smspar refers to the Default pubset.

AVAILABILITY=HIGH

The file should be stored within the SM pubset on a Volume set that is classified as higher availability (e.g. DRV mirrored volumes).

STORAGE-CL=class

Name of a Storage Class created by the system administrator. The Storage Class determines the Volume set of the file, and hence the storage characteristics, such as Performance Attribute, Availability etc.

VOLUME-SET=vset

Determines the Volume set on which the file should reside within the SM pubset. The system administrator can specify a volume explicitly by means of a one to four digit Cat-id vset (without the ':'), or *CONTROL.

The non-privileged user can only specify a Volume set when the system administrator has allowed physical allocation rights.

WORK-FILE=YES|NO

Specifies whether the file is a Work file, and hence may be deleted by the system administrator after a particular time period has elapsed. Work files will be created on Volme sets which have been designated WORK.

STD This parameter is only important when copying files or Job variables. Normally, the ONXCOPY Variable Action will pass the protection attributes of the source file, e.g. ACCESS=READ, RETPD or passwords, to the target file (COPY ..,SAME).

The STD parameter will result in the source file not being copied with "COPY ..,SAME". The protection attributes of the source file will thus not be copied automatically.

Notes:

Library elements will be copied to the current library. This Variable Action is translated internally to ONXADD 'str1'='str2' lib. The ONXCOPY Variable Action is only valid for PLAM libraries.

In contrast to the Copy command of BS2000, the attributes of the original file are transferred when using the ONXCOPY Variable Action (equivalent to COPY ,SAME). The files created or overwritten by the ONXCOPY Variable Action will have the same Share, Access and Backup Level attributes as the original files.

The PAMCONV program will be called internally by the Variable Action when copying files with BLKCTRL=PAMKEY to a nonkey PVS.

Copied files will automatically be added to the end of the file list.

Examples:

ONXCOPY''='ABC.S.' Prefix with 'ABC.S.'

e.g. TEST --> ABC.S.TEST

ONXCOPY' '='.88' Suffix with '.88'

e.g. ABC.S.TEST --> ABC.S.TEST.88

ONXCOPY''=''

This Variable Action is only relevant if the selected userid is not that under which the user logged on. The files/Job variables of the selected userid will be copied without name changes to the users own id.