ONXADD Add Files to Library

ONXADD [t/] ['str1'= ...] library [,CA] [,CPR]

The files/library elements will be added to the specified library. Copying from one PLAM library to another will result in the version description being copied as well. The version description will not be copied when copying an ISAM-LMS element. No version description will be created when adding files to PLAM libraries.

'str1'= ... Name Transformation Rules

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

'str1'='str2'

The name of the new library element will be constructed by searching the original name for the string 'str1' and replacing it by 'str2'. By default, the empty string '_' appears at the end of every name, and the null string '' at the beginning. If the original name does not contain 'str1', the Variable Action will not be executed for this data object.

'str1'=DP[n][I]

Delete Prefix: The name of the new library element 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 library element 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.

If 'str1'=... is omitted, the name of the new library element will be identical to the original name. For further information regarding name transformation rules, see page 5-. Examples of name transformation can be found below.

t Only when adding to PLAM libraries: The data objects marked with an X are added to the specified library as elements of the specified type. If no type is given, S/ will be used as standard. When copying elements from one PLAM library to another, if no element type is specified, the newly created element will be the same type as the original.

When marking the files to be defined for the Variable Action, the user may amend the element type by entering the Action Code Xt. t will specify a different type to that in the Variable Action. The type specified in an Action Code takes precedence over a type defined in a Variable Action. E is not a valid element type in an Action Code, since XE will be interpreted by CFS as a command to erase the source file or element after successfully adding it to the target library.

library Name of the library to which the element should be added.

CA Copy All Delta Versions. This parameter is only valid when copying elements stored in Delta format between two PLAM libraries. Delta format elements will be copied with the structure intact, i.e. all versions belonging to the element will be copied to the new library. If the CA option is not specified (standard), then only the version marked with an X will be copied to the target library.

CPR Copy Protection Attributes. This parameter is only valid when copying elements between two PLAM libraries under the same userid. Existing Read, Write and Execute passwords, as well as the Basic Access Control List (BACL) of the source element are created for the new element created in the target library. If the target library needs to be created, then the library and type attributes used will be taken from the source library. Library attributes are defined by the administration rights (see page 6-) and the standard protection attributes for new elements (see page 6-). Type attributes are defined by standard protection attributes for newly created elements of that particular type.

Notes:

The USER-DATE and USER-TIME fields in the library directory are available for PLAM library elements. The user may enter any date in this field. When adding files or library elements to a PLAM library, the user date from the original element will be transferred, together with the element.

When copying elements from one PLAM library to another, the contents of the USER-DATE and USER-TIME fields will also be transferred to the new library. See the Variable Action ONXSETUDAT on page 5- for more information.