Suffixing

Some Batch Loader statements support the SUFFIX keyword. This allows a variable value to be suffixed onto the name of the object.

SUFFIX supports the following variables:

CDAY: Current day of the week as a number 1=Monday.
CDD: Current day of the month.
CDDD: Current day of the year.
CDDMMYY: Current date in DDMMYY format.
CHH: Current hour.
CHHMM: Current time in HHMM format.
CHHMMSS: Current time in HHMMSS format.
CHHMMSSX: Current time in HHMMSSXX format.
CMM: Current month.
CMMYY: Current month and year in MMYY format.
CYMD: Current date in YYYYMMDD format.
CYY: Current year in YY format.
CYYDDD: Current Julian day in YYDDD format.
CYYMM: Current year and month in YYMM format.
CYYMMDD: Current date in YYMMDD format.
CYYYY: Current year in YYYY format.
CYYYYMM: Current year and month in YYYYMM format.

If SUFFIX is used to specify anything other than these variables, it is treated as a literal.

Once a particular variable has been referenced in an execution of Workload Automation Programming Language, any subsequent references return the same value. For example, CHHMMSSX referenced twice in the same Batch Loader, returns exactly the same value, despite the fact the second reference might be processed a few hundredths of a second later. This is to allow SUFFIX to be used to create an Application name, and then be able to reliably make dependencies to it.

The following example creates two dynamic applications using CHHMMSSX to create an Application name containing the time down to one hundredth of a second. Because the variables are static within Workload Automation Programming Language, both applications will have the same timestamp, but importantly the second Application can be made dependent on the first.

OPTIONS CPDEPR(Y)                                                   
ADSTART ACTION(SETDEFAULT) ADOP DURATION(1)                         
ADSTART ACTION(SUBMIT) ADID(DYNAMIC1) SUFFIX(CHHMMSSX)              
        DESCR('SEQUENCE OF JOBS') OWNER(TWS)                        
ADOP WSID(NONR) OPNO(FIRST) AUTOPRED(PREV)                          
ADOP WSID(CPU1) JOBN(JOB1)                                          
ADOP WSID(CPU1) JOBN(JOB2)                                          
ADOP WSID(CPU1) JOBN(JOB3)                                          
ADOP WSID(NONR) OPNO(LAST)                                          
ADSTART ACTION(SUBMIT) ADID(DYNAMIC2) SUFFIX(CHHMMSSX)              
        DESCR('SEQUENCE OF JOBS') OWNER(TWS)                        
ADOP WSID(NONR) OPNO(FIRST) AUTOPRED(PREV)                          
ADDEP PREADID(DYNAMIC1) SUFFIX(CHHMMSSX) PREOPNO(LAST) PREWSID(NONR)
ADOP WSID(CPU1) JOBN(JOB4)                                          
ADOP WSID(CPU1) JOBN(JOB5)                                          
ADOP WSID(CPU1) JOBN(JOB6)                                          
ADOP WSID(NONR) OPNO(LAST)

Note: OPTIONS SUFFIX is used to control the behavior of the SUFFIX keyword, to manage situations where the addition of the suffix might exceed the maximum allowed length of the object name.