gtps1m1t | System Macros |
Use this system macro to perform the following operations on your list notification vector:
Format
|
To code, specify the name or address of an 8-byte field that contains the token for the list notification vector.
To code, specify the name or address of a work area that begins on a word boundary.
Specify one of the following:
The TPF system tries to expand or contract your list notification vector to the size you specify.
To code, specify the name or address of the fullword field that contains the requested list notification vector length.
To code, specify the name or address of the fullword field to contain the new list notification vector length if it differs from the requested list notification vector length.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
If REQUEST=TESTLISTSTATE is coded, this parameter specifies a fullword field that contains the vector index entry associated with the list of interest. For a vector with N entries, valid vector index values range from 0 to N-1.
To code, specify the name or address of the label.
To code, specify the name or address of a fullword field.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
To code, specify the name or address of the label.
Entry Requirements
None.
Return Conditions
When the CFVCTC macro returns control to your program, register 15 (R15) is undefined and all remaining registers are unchanged.
The following tables contain the reasons for which each branch routine may
be called and the suggested recovery actions.
Table 3. Branch Routines for the CFVCTC Macro with REQUEST=MODIFYVECTORSIZE Coded
Routine | Meaning and Action |
---|---|
MODIFYDONE | Meaning: The list notification vector was modified as
requested.
Action: None. |
LESSTHAN | Meaning: This is a system error. The list
notification vector is smaller than the size you requested because there was
not enough storage available. The new number of vector entries is
returned in the field specified by the ACTUALVECTORLEN parameter.
Action: Do the following:
|
NOSTORAGE | Meaning: This is a system error. Storage could
not be obtained to increase the list notification vector size. The size
remains unchanged.
Action: Do the following:
|
INVALIDTOKEN | Meaning: This is a program error because the vector
token you specified on the VECTORTOKEN parameter is not valid.
Action: Do the following:
|
INVALIDLEN | Meaning: This is a program error because the list
notification vector length you specified on the VECTORLEN parameter is not
valid. The list notification vector length must be greater than or
equal to 1.
Action: Do the following:
|
Table 4. Branch Routines for the CFVCTC Macro with REQUEST=LTVECENTRIES Coded
Routine | Meaning and Action |
---|---|
ALLEMPTY | Meaning: All associated lists in the range of vector
entries are empty.
Action: None. |
SOMENONEMPTY | Meaning: A list in the range of vector entries is not
empty.
Action: None. |
INVALIDINDEX | Meaning: This is a program error because the vector
index you specified on the VECTORINDEX parameter is not valid.
Action: Do the following:
|
INVALIDTOKEN | Meaning: This is a program error because the vector
token you specified on the VECTORTOKEN parameter is not valid.
Action: Do the following:
|
Table 5. Branch Routines for the CFVCTC Macro with REQUEST=TESTLISTSTATE Coded
Routine | Meaning and Action |
---|---|
LISTEMPTY | Meaning: This list is empty.
Action: None. |
LISTNONEMPTY | Meaning: The list is not empty.
Action: None. |
INVALIDINDEX | Meaning: This is a program error because the vector
index you specified on the VECTORINDEX parameter is not valid.
Action: Do the following:
|
INVALIDTOKEN | Meaning: This is a program error because the vector
token you specified on the VECTORTOKEN parameter is not valid.
Action: Do the following:
|
Programming Considerations
Examples