NetBatch Management Programming Manual

Commands and Responses
NetBatch Management Programming Manual—522462-003
5-13
ADD ATTACHMENT-SET Command
ZBAT-TKN-VOLUME-SUBVOL
specifies the default node, volume, and subvolume used for qualifying unqualified
file references in ZBAT-TKN-ATT-SET-DEFINE. To avoid unpredictable file-name
expansion when your application omits ZBAT-TKN-VOLUME-SUBVOL, fully qualify
all file names in ZBAT-TKN-ATT-SET-DEFINE.
Tokens in Response Buffer
For information on the tokens present in the response buffer, see Section 4, Common
Definitions. Information on the tokens specific to the ADD ATTACHMENT-SET
command is:
ZBAT−TKN−ATT−SET−ID
is the ID of the new attachment set in the form (the ID appears as an ASCII string):
[ ( user-ID ) ] attachment-set-ID
user-ID
specifies the user ID of the attachment-set owner in the form
group-name.user-name.
attachment-set-ID
is one of:
attachment-set-name
specifies the attachment-set name.
attachment-set-number
specifies the attachment-set number.
Examples of attachment-set IDs are (FPP.USER)DAILY and (SUPER.FPP)66.
Operational Notes
•
The ADD ATTACHMENT-SET command is a sensitive command available to all
users.
•
An ADD ATTACHMENT-SET command will fail if it specifies more ASSIGNs,
DEFINEs, and PARAMs than will fit in the command buffer. To add an attachment
set that contains more ASSIGNs, DEFINEs, and PARAMs than will fit in the
command buffer, send an initial ADD ATTACHMENT-SET command followed by
one or more ALTER ATTACHMENT-SET commands. Specify the TEMPORARY
ON attribute in the ADD ATTACHMENT-SET command and the TEMPORARY
OFF attribute in the final ALTER ATTACHMENT-SET command. The scheduler
deletes the incomplete attachment set if the requester process fails before
completing all ALTER ATTACHMENT-SET commands.