The OPSGETVL command processor retrieves the names of global variables that match a variable name mask that you specify. Depending on the keywords that you specify for your OPSGETVL request, CA OPS/MVS either displays the list of variables on your terminal or stores them in CLIST or REXX variables. Typically, you will use the retrieved variable names in subsequent variable manipulation operations.
In addition to invoking OPSGETVL as a TSO command, you can invoke it as an OPS/REXX or TSO/E REXX function. The function has a single argument equal to the OPSGETVL TSO command syntax. The value returned by the function is the count of retrieved variable names. The CA OPS/MVS product sets the OPSRC variable to the same return code that would have been generated if you had invoked OPSGETVL as a TSO command.
This command has the following format:
OPSGETVL
{namemask}
[prefix]
[CMDRESP(TERMINAL|REXX|CLIST|NOWHERE)]
[DELAY(0,seconds)]
[MAX(99,count)]
[SORT(ASCEND|DESCEND)]
[SUBSYS(OPSS,ssid)]
[SYSTEM(msfids)]
[SYSWAIT(seconds)]
[TOKEN(nn)]
For the value of namemask, specify either a complete variable name or a variable name that includes one or both of the special characters described here. The CA OPS/MVS product searches through the global variables on the specified system and tries to find any names that match namemask.
The namemask can be up to the maximum global variable size in length, and is automatically converted to uppercase.
You can use two special characters in the namemask:
The namemask that you specify can be either of the following:
Guidelines for specifying namemask:
namemask examples:
GLOBAL0.ABCD*
Matches all CA OPS/MVS global variable names with 12 or more characters that begin with GLOBAL0.ABCD, such as GLOBAL0.ABCDEF.
TAPE_+++_STATUS
Matches all Automate-format variable names with 15 characters, where the sixth through eighth characters can be any character and the other characters are equal to those in the mask, such as TAPE_280_STATUS.
+++
Matches all Automate-format variable names composed of three characters.
+++*
Matches all Automate-format variable names composed of three or more characters.
GLVTEMP1.*
Matches all CA OPS/MVS global variable names that begin with the stem GLVTEMP1.
Note: If you specify a value for prefix, it must precede any other optional keywords that you specify.
(Optional) When you invoke OPSGETVL from a CLIST or REXX EXEC, you can assign the retrieved variable names to a variable array. Use the prefix operand to indicate the prefix of the CLIST or REXX variable names into which the retrieved variable names are to be stored.
Default: GETVL
The value of prefix affects the following:
For more information, see CLIST or REXX Variables Generated by OPSGETVL in this chapter.
(Optional) The CMDRESP keyword specifies where the output goes when OPSGETVL executes. Values are:
Displays the response (number of variable names returned, the token, and all variable names selected) at the terminal.
Generates an output variable array using the REXX stem variable format, which is prefix.index.
Generates an output variable array using the CLIST variable name format, which is prefix||index.
Tells CA OPS/MVS that it should not issue any messages except error messages. This option is provided to eliminate messages in REXX programs.
When you invoke your OPSGETVL request as a TSO command, the default of CMDRESP is both CMDRESP(TERMINAL) and CMDRESP(CLIST).
When you invoke your OPSGETVL request as an OPS/REXX or TSO/E REXX function, the default of CMDRESP is CMDRESP(REXX).
Note: Values of CMDRESP(CLIST) and CMDRESP(REXX) are honored only when the appropriate variable creation environment is possible.
For more information, see CLIST or REXX Variables Generated by OPSGETVL in this chapter.
(Optional) The DELAY keyword indicates the number of seconds that your OPSGETVL request waits before it can be processed. The default is 0; you can specify any number of seconds from 1 to 300.
(Optional) The MAX keyword indicates the maximum number of variable names that CA OPS/MVS is to return for this OPSGETVL request. If more matching variable names exist than the number specified by count, CA OPS/MVS generates a resume token. The default is 99; you can specify any number from 1 to 2048.
(Optional) The SORT keyword tells CA OPS/MVS how to sort the returned variable names before displaying them or assigning them to CLIST or REXX variables.
Values are:
(Default) Sort the variable names in ascending order.
Sort the variable names in descending order.
(Optional) For more information on the SUBSYS keyword, see Specifying a Subsystem ID on a POI Command Processor in this chapter.
(Optional) For more information on the SYSTEM keyword, see Specifying an MSF System ID on a POI Command Processor in this chapter.
Note: You may specify a single system only.
(Optional) For a cross-system request, the SYSWAIT keyword specifies the number of seconds that CA OPS/MVS should wait for the remote system to receive and respond to the OPSGETVL request. The default is the value of the MSFSYSWAIT parameter; you can specify any number of seconds from 1 to 600.
(Optional) Use the TOKEN keyword to specify the numeric token number that was returned by a previous OPSGETVL request. By specifying a value for this keyword, you indicate that CA OPS/MVS should start the current search for matching variable names at the variable name following the last name that was returned by the previous OPSGETVL request. The TOKEN keyword is useful when large numbers of variable names are being retrieved. There is no default.
Examples: OPSGETVL
OPSGETVL GLOBAL0.XYZ+ABC* MAX(200)
cnt = OPSGETVL('GLOBAL0.XYZ* VNAME')
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|