Symbolic Parameters

Symbolic parameters let you store transfer parameters in control files with variable data that is resolved to other values at schedule time. Standard symbolic parameters are supplied with CA XCOM Data Transport. You can use symbolic parameters as SYSIN01 parameters in the SYSIN01 DD statement of the XCOMJOB JCL. 
xdtz12
Symbolic parameters let you store transfer parameters in control files with variable data that is resolved to other values at schedule time. Standard symbolic parameters are supplied with CA XCOM Data Transport. You can use symbolic parameters as SYSIN01 parameters in the SYSIN01 DD statement of the XCOMJOB JCL. 
No setup is required to use the predefined variables that are integrated as part of CA XCOM Data Transport. If you place variables in the parameter data set for a transfer, CA XCOM invokes them when scheduling the transfer.
&DATE(format-code)
&DATE causes the current date to be substituted dynamically in the current keyword value. The format of the date depends on the format code that is selected as a sub parameter. If no format is specified,
YYYYMMDD
is used. Valid format-codes and examples of their output are:
  • MMDDYYYY
    -- 12312013
  • DDMMYYYY
    -- 31122013
  • YYYYMMDD
    -- 20131231
  • YYMMDD
    -- 131231
  • YYYY
    -- 2013
  • YY
    -- 13
  • MM
    -- 12
  • DD
    -- 31
  • YYDDD
    -- 13366
  • YYYYDDD
    -- 2013366
  • DDMONYYYY
    -- 31DEC2013
  • MON
    -- DEC
  • MONTH
    -- DECEMBER
&IPNAME
&IPNAME causes the value that is entered for IPNAME to be substituted dynamically in the current keyword value.
&LU
&LU causes the value that is entered for LU to be substituted dynamically in the current keyword value.
&LUSER
&LUSER causes the current LOCAL user ID (or the USERID of the current job) to be substituted dynamically in the current keyword value.
&USERID
&USERID causes the current REMOTE user ID (or the USERID of the current job) to be substituted dynamically in the current keyword value.
&ID
&ID causes the value that is entered for ID to be substituted dynamically in the current keyword value.
&TIME
&TIME causes the current time to be substituted dynamically in the current keyword value. The format of the time depends on the format code that is selected as a sub parameter. Valid
format
-
code
s and examples of their output are:
  • HHMMSSTH
    -- 15312811
  • HHMMSS
    -- 153128
  • HHMM
    -- 1531
  • MMSS
    -- 3128
  • HH
    -- 15
  • MM
    -- 31
  • SS
    -- 28
  • TH
    -- 11
  • TH3
    -- 110
The TH3 format-code is only accurate to 1/100th of a second so the last digit is always 0.
How to Use Symbolic Parameters
You can place symbolic variables in any combination in SYSIN01 control statements to create composite parameter values. You can use a period (.) as a terminating character for the symbolic variable, but it is not required. If a period is present, it is removed from the resultant field content.
Example
ID=X-&TIME(HH):&TIME(MM):&TIME(SS)
This results in the value for ID being set to:
X-15:31:28
If the symbolic variable does not have a system value, assign a value before using the symbolic variable. You can also specify subscripts on symbolic variables that do not have a format-code. There are two formats for subscripted symbolic variables. If only one numeric value is present, a starting position of 1 is assumed. A second subscript format allows for a starting position and a length to be entered:
Example (one subscript)
LU=L784000 ID=LU#&LU(4)
This results in the value for ID being set to:
LU#L784
Example (two subscripts)
LU=LU250021 ID=LU#&LU(5,4)
This results in the value for ID being set to:
LU#0021
Which SYSIN01 Statements Support Symbolic Parameters?
You can use symbolic parameters on the following SYSIN01 statements:
  • CHARS
  • DEST
  • FCB, FILE, FILEOPT, FILETYPE, FORM
  • GROUP
  • ID, IPNAME
  • LCLNTFYL, LFILE, LIST, LU, LUNIT, LUSER, LVOL
  • NOTIFY, NOTIFYNAME
  • OEDATE, OETIME, OFILETYPE, OID, OLMSG, OLU, OREQ, OSDATE, OSTIME, OTNAME, OTYPE, OTYPEREQ, OUSER
  • REPORT, RMNTNTFYL, RNOTIFY, RNOTIFYNAME
  • SYSUDATA
  • TDUDATA, TRUSTED, TYPE
  • UNIT, USER, USERID
  • VOL
  • WRITER
  • XCOM_CONFIG_SSL, XTCERRDECR, XTCERRINCR, XTCERRPURGE, XTCERRREL, XTCGOODDECR, XTCGOODINCR, XTCGOODPURGE, XTCGOODREL, XTCJOB, XTCNET