Enhancements and New Features › Substringing of Symbolic Variables for Long Name Files

Substringing of Symbolic Variables for Long Name Files

The processing of the substring option when used with the symbolic variables (symbols) for long file names has changed. This processing change can produce a different result for the following symbols:

&C1USRPATH

USS path name of the source for Add or Update requests. Fixed length of 768.

&C1USRFILE

Source USS file names for Add or Update requests. Fixed length of 255.

&C1ELMNT255

1- to 255-character name for element names greater than 10 characters and mixed/lower case names less than 10 characters. Fixed length of 255.

&C1SELMNT255

1-255 character name for elements at the source location of actions such as Move and Transfer. Fixed length of 255.

&C1TELMNT255

1-255 character name for elements at the target location of actions such as Move and Transfer.Fixed length of 255.

Now during symbolic substitution, the found values are padded with spaces to a fixed length. If one of these symbols uses the substring feature with a start position greater than the number of characters in the found value, but less than the fixed length, then the substring function is performed. However, the result is spaces.

For example, assume the symbolic is coded as &C1ELMNT255(20,4) and &C1ELMNT255 is found to contain ELEMENT1. The substring values are coded as (start,length), so that the 20th position within the found value is where substringing is to begin. The length of the substring is 4.

In this example, four blank spaces will be substituted for the substringed symbolic variable. The reason being, the 20 character start value has a larger number of characters than the actual value of ELEMENT1. When this occurs, CA Endevor SCM assumes blank spaces for all the characters after ELEMENT1 when determining the start position. Therefore, the four characters found beginning at the start position are all blanks. So, the substitute value consists of four blank spaces.

Previously, if one of these symbols was coded using the substring feature with a start position greater than the number of characters in the found value, then the substring function was not performed. The substituted variable was the entire found value followed by the hardcoded string (start,length). Thus before this enhancement, assuming the previous example, the following would have been substituted: ELEMENT1(20,4)

Note: This change was also introduced as a PTF in release 15.1 in the fall of 2013.

Note: For more information about how to use substringing, see Substringing in the Extended Processors Guide.