Customization › DESTID Statement › DESTID Attribute Assignment

DESTID Attribute Assignment

There are two parts to the process of attribute assignment:

• Default attribute assignment

  This occurs when no value is previously specified during file creation.

• Forced attribute assignment

  This occurs regardless of any value previously specified during file creation.

DESTID processing is performed twice for each file during ESFOPEN and ESFCLOSE. Most file attributes can be changed during both phases; but some only during one. See the "Initialization" chapter in this guide for individual attribute details.

Note: XEQOPT=20 can be used to bypass the DESTID FDEST merge at file CLOSE time. Other DESTID file attributes, such as CLASS and HOLD, continue to be processed during ESFCLOSE.

Example 1

ESFPARM has:

DESTID QUSERID=ABC*,FDEST=MYPRINT
DESTID QCLASS=X,FDEST=DUMMY

Files in CLASS X are queued for the destination called DUMMY.

Files with user ID that have ABC as the first three characters are queued for destination MYPRINT, even if they have class X. This is because a matching user ID takes priority over a matching class.

Example 2

ESFPARM has:

DESTID QUSERID=ABC*,FDEST=(JES2.*,*)

Files for destinations that have ABC in the first three characters of their names are queued for two destinations, as follows: 'JES2.*' causes the files to be queued for transmission to the original destination at the JES2 NJE node; the (*) is the other destination, the original destination of the file.

Example 3

ESFPARM has:

DESTID QDEST=MYPR*,QUSERID=ABC*,FCLASS=Z
DESTID QCLASS=Z,QDEST=MYPRT1,FCLASS=B,FHOLD=YES
DESTID QCLASS=Z,QDEST=MYPRT2,FCLASS=C

Files for destinations named MYPR as the first four characters, having user IDs starting with ABC, are requeued to class Z.

Files for class Z and destination MYPRT1 are requeued for class B, and are placed in held status. Files for class Z and destination MYPRT2 are requeued for class C. Files moved to CLASS=Z, due to the first DESTID statement, are processed as determined by the two last DESTID statements encountered during close processing.

This technique makes a two-level file selection possible; this can be especially useful to enable special DESTID processing for a large number of subsets of files.