Previous Topic: GET function variable output:Next Topic: Sample Coding Statements


GETLIKE function variable output:

The GETLIKE function reads the variables that match a name mask as specified within the supporting NAME keyword and returns the list of variable names, values, and attributes in unique stemmed variables. The default stemmed variable names begins with VASRV_, or can optionally be named by using the PREFIX keyword. The OPTIONS keyword can be used to select or limit the data that is returned if needed.

The default stemmed variables that are created from a GETLIKE function call without the PREFIX keyword are:

VASRV_NAME.0

The count total of variables that match the specified stem mask.

VASRV_NAME.x (x = 1 to total count returned in vasrv_name.0)

Full variable name

Length: 1-128

Example: GLVPLXT1.STATUS.SYSTEM

VASRV_VALUE.x (x = 1 to total count returned in vasrv_name.0)

These VALUE variables contain multiple word values.

Note: These variables are not created if the OPTIONS(NOVALUES) keyword was specified on the GETLIKE function.

Word 1

Variable data type name

Length: 8

The Supported data types are: UNDEF, SIGNED32, STRING, or XML.

Words 2-n

Variable data value

Length: 1-30000

Example value for a VASRV_VALUE.x variable: UNDEF PROD CICSA ACTIVE ON SYSTEMX

VASRV_TOKEN.x (x = 1 to total count returned in vasrv_name.0)

The variable token value in printable hex characters.

Note: These variables are only created when the OPTIONS(STATS) keyword is specified on the GETLIKE function.

Length: 32

Example value for a VASRV_TOKEN.x variable: FFFFFFFFF2F4F6F9FFFFFFAFCF2F0F0

VASRV_INFO.x (x = 1 to total count returned in vasrv_name.0)

These INFO variables contain multiple word values.

Note:These variables are only created when the OPTIONS(STATS) keyword is specified on the GETLIKE function.

Word Number: 1

Variable product name

Length: 1-16

For CA OPS/MVS, the variable product name is always CA OPS/MVS.

Word Number: 2

Variable instance name

Length: 1a-16

For CA OPS/MVS, the variable instance name is always a CA OPS/MVS subsystem name such as OPSS.

Word Number: 3

Variable group name

Length: 1-16

Example: PRODPAYROLL

Word Number: 4

Variable data type name

Length: 5-8

Example: STRING

Word Number: 5

Variable scope

Length: 7

For CA OPS/MVS, the scope is always SYSPLEX.

Word Number: 6

Variable is eligible to trigger a )GLV rule.

Length: 1

Y=Yes or N=No

Word Number: 7

Persist attribute.

Length: 4

TEMP (temporary) is the only value supported.

Word Number:8

Length: 1-8

Contains the system name that created the variable.

Word Number: 9

Creation user ID or job name.

Length: 1-8

Word Number: 10

Length: 1-8

Contains the program name or the memory address of the program that created the variable.

Word Number: 11

Length:10

Creation date in YYYY/MM/DD format

Word Number: 12

Length:8

Creation time is in HH:MM:SS (UTC time)

Word Number: 13

Length: 1-8

Contains the system name that updated the variable

Word Number: 14

Length: 1-8

Contains the User name or Job name that updated the variable

Word Number: 15

Length: 1-8

Contains the name or the memory address of the program that updated the variable

Word Number: 16

Length:10

Update date in YYYY/MM/DD format

Word Number: 17

Length:8

Update time is in HH:MM:SS format (UTC time)

Word Number: 18

Length:10

Last reference date in YYYY/MM/DD format

Word Number: 19

Length:8

Last reference time is in HH:MM:SS format (UTC time).

Refer to Sample Coding Statements for samples on using the GETLIKE function for more details.