The data set name mask and the directory path contain the following symbolic qualifiers:
This is a unique name that identifies each data set. It consists of one or more qualifiers separated by periods, and has a maximum input length of 64 characters, including the periods. When the data set name mask is translated is has a maximum length of 44 characters including the periods.
This is a USS path name, it consists of one or more directory leaves separated by forward slashes, and has a maximum input length of 255 characters including slashes. When the Directory Path is translated it has a maximum length of 255 characters.
Symbolic substitution, or translation, is a process performed by CA CSM to resolve the mask values specified in the data set name mask and directory path, into real names based upon the contents of the symbolic variables at translation time. A CA CSM symbol is defined in the list of symbols. Each symbol begins with an ampersand (&) and ends with a period (.). For example, the symbol &LYYMMDD. would be completely replaced with its value at translation time, including the ampersand and trailing period. The trailing period is important and is considered part of the symbolic name.
You can use symbolic variables in the construction of a data set name with the value of the symbolic variable to end a data set name segment.
Example: Assume MSMDID is 255.
SYSWORK.D&MSMDID..DATASET
Note: The double periods are necessary because the first period is part of the symbolic name, and therefore does not appear in the translated value.
The final data set name is SYSWORK.D255.DATASET.
Some CA CSM symbolic names translate to numeric values. In the case where you want to use one of these symbolic variables in your data set name, you may have to precede it with a alpha constant. This is because z/OS data set naming rules do not allow a data set name segment to start with a numeric.
If you wanted to use a date value in your translated data set name, you could use one of the CA CSM defined date symbolic qualifiers such as &LYYMMDD. You must be careful how you construct the data set mask value.
Example: Assume that you want to have a middle level qualifier to have a unique value based upon the date of April 1, 2010.
Mask = SYSWORK.D&LYYMMDD..DATASET, translates to SYSWORK.D100401.DATASET
An incorrect specification of the mask would be:
SYSWORK.&LYYMMDD..DATASET, translates to SYSWORK.100401.DATASET. Because the middle-level qualifier starts with a numeric it is an invalid data set name.
Symbolic substitution works in the same logical way for directory paths. However, directory paths do not typically have periods in them, so you will typically not see the double dots in directory paths.
Example: Assume the target system is SYSZ.
/u/usr/&MSMSYSNM./deployments translates to /u/usr/SYSZ/deployments.
Preview Example
Before a Product Deployment is deployed, the MSMDID shows as ???. After deployment, the Automatic ID is assigned and this is the MSMDID.
Symbolic Qualifiers
This is the CA CSM deployment ID.
Limits: This is automatically assigned by CA CSM when the Deploy button is clicked or when a deployment is saved.
This is the CA CSM Mount Point Name. The value is entered into the mount point name field when adding a custom data set with both the USS radio button and the Container copy radio button set. It is of primary value in remote path.
Note: The Mount Point Name field can contain symbols when it is translated first, the value of the MSMMPN variable is resolved.
Example: Assume the value of MSMDID is 253 and the user entered the following information.
Mount point name: /u/users/deptest/R&MSMDID./leaf
Remote path: &MSMMPN.
The translated value of &MSMMPN is /u/users/deptest/R253/leaf
This is the CA CSM system object name.
This is the shorthand name of the system.
Limits: Maximum 2 characters.
This is the system name entered when a non-sysplex, sysplex, shared DASD cluster, or staging system is created.
This is the system name entered when a sysplex is created.
Note: This symbolic may not be used for a non-sysplex system.
The current user ID.
MSMHLQ is the high-level qualifier for the target library.
Limits: It is the characters before the first period in a fully qualified data set name. The high-level qualifier can be from 1 to 8 characters.
Example: For the data set JOHNSON.FINANCE.DIVISION.SCRIPT, the high-level qualifier is JOHNSON.
MSMMLQ is the middle-level qualifier for the target library.
Limits: It is the characters after the first period and before the last period in a fully qualified data set name. The middle-level qualifier size can vary based on the number of qualifiers defined.
Example: For the data set JOHNSON.FINANCE.DIVISION.SCRIPT, the middle-level qualifier is FINANCE.DIVISION.
MSMLLQ is the low-level qualifier for the target library.
Limits: It is the characters after the last period in a fully qualified data set name. The low-level qualifier can be from 1 to 8 characters.
Example: For the data set JOHNSON.FINANCE.SCRIPT, the low-level qualifier is SCRIPT.
This is the secondary low-level qualifier for the target library and it is the "segment" of the data set name just before the low-level qualifier (MSMLLQ).
Limits: It is the characters after the second to last period and before the last period in a fully qualified data set name. The secondary low-level qualifier can be from 1 to 8 characters.
Example: For the data set JOHNSON.FINANCE.SECOND.SCRIPT, the low-level qualifier is SECOND.
This is the target library prefix. The target library prefix is the entire data set name to the left of the MSMLLQ.
Example: For the data set JOHNSON.FINANCE.DIVISION.SCRIPT the prefix is JOHNSON.FINANCE.DIVISION.
The deployed library number is a unique number, for each deployed library, within a deployment.
Example: Assume 3 target libraries in a deployment.
DSN = USER456.LIBR473.CAIPROC DSN = USER456.LIBR473.CAILOAD DSN = USER456.LIBR473.CAIEXEC
Assume the methodology specified a mask of:
&SYSUID..D&MSMDID..LIB&MSMDLIBN
Assume USERID is USER789, and the deployment ID is 877, then the resolved DSNs would be,
Deployed library = USER789.D877.LIB1.CAIPROC Deployed library = USER789.D877.LIB2.CAILOAD Deployed library = USER789.D877.LIB3.CAIEXEC
DLQUAL1 is the high-level qualifier for the target libraries.
Limits: It is the characters before the first period in the fully qualified data set name. This qualifier can be from 1 to 8 characters and is functionally equivalent to the symbolic qualifier MSMHQL.
Example: For the data set JOHNSON.FINANCE.DIVISION.SCRIPT, the high-level qualifier is JOHNSON.
These represent the qualifier within the numbered position of the data set name. This means that DLQUAL2 represents the second qualifier and DLQUAL6 represents the sixth qualifier.
Limits: The individual qualifiers can be 1 to 8 characters.
Example: For the data set JOHNSON.FINANCE.DIV1.REPORT.SCRIPT, DLQUAL2 is FINANACE, and DLQUAL5 is SCRIPT.
This is the local two-digit year.
YY two-digit year
MM two-digit month (01=January)
DD two-digit day of month (01 through 31)
Example: 100311
This is the local two-digit year.
LYR2 two-digit year
Example: 10
This is the local four-digit year.
LYR4 four-digit year
Example: 2010
This is the local month.
LMON two-digit month (01=January)
Example: 03
This is the local day of the month.
LDAY two-digit day of month (01 through 31)
Example: 11
This is the local Julian day.
LJDAY three-digit day (001 through 366)
Example: The Julian day for January 11th is 011.
This is the local day of the week.
LWDAY is three characters in length. The days are MON, TUE, WED, THR, FRI, SAT, and SUN.
Example: MON
This is the local time in hours, minutes, and seconds.
HH two digits of hour (00 through 23) (am/pm NOT allowed)
MM two digits of minute (00 through 59)
SS two digits of second (00 through 59)
Example: 165148
This is the local time in hours.
LHR two-digits of hour (00 through 23) (am/pm NOT allowed)
Example: 16
This is the local time in minutes.
LMIN two-digits of minute (00 through 59)
Example: 51
This is the local time in seconds.
LSEC two-digits of second (00 through 59)
Example: 48
Coordinated Universal Time is abbreviated UTC.
This is the UTC date.
YY two-digit year
MM two-digit month (01=January)
DD two-digit day of month (01 through 31)
Example: 100311
This is the UTC two digit year.
YR2 two-digit year
Example: 10
This is the UTC four digit year.
YR4 four-digit year
Example: 2010
This is the UTC month.
MON two-digit month (01=January)
Example: 03
This is the UTC day of the month.
DAY two-digit day of month (01 through 31)
Example: 11
This is the UTC Julian day.
JDAY three-digit day (001 through 366)
Example: The Julian day for January 11th is 011.
This is the UTC day of the week.
WDAY is three characters in length. The days are MON, TUE, WED, THR, FRI, SAT, and SUN.
Example: MON
This is the UTC time in hours, minutes, and seconds.
HH two-digits of hour (00 through 23) (am/pm NOT allowed)
MM two-digits of minute (00 through 59)
SS two-digits of second (00 through 59)
Example: 044811
This is the UTC time in hours.
HR two digits of hour (00 through 23) (am/pm NOT allowed)
Example: 04
This is the UTC time in minutes.
MIN two-digits of minute (00 through 59)
Example: 48
This is the UTC time in seconds.
SEC two-digits of second (00 through 59)
Example: 11
|
Copyright © 2014 CA.
All rights reserved.
|
|