Usage. CA CA TPX Session Management
Iklan
Iklan
ADD Command
Usage
ADD Command
The ADD command adds the value of an accumulator or integer to an accumulator.
Format
If you do not specify a session, the program runs in the current session and the current program is suspended until the called program completes execution.
All user-defined variables are available to the ACL/E program that is called.
The ADD command has the following syntax:
>>--accumulator 1 ------- accumulator 2 ---------------><
+- n ---------------+
+- variable --------+
Operands
The ADD command has the following operands:
Operand Explanation
accumulator 1 Specifies one of the four accumulators, A1 through A4, that is incremented by the ADD command.
accumulator 2 Specifies an accumulator whose contents is added to the accumulator you specified in accumulator 1.
n
variable
Specifies an integer that is added to the specified accumulator.
Specifies a numeric variable that is added to the specified accumulator.
ATTN Command
The ATTN command issues an attention interrupt to the application.
Appendix D: Command Summary 123
BRANCH Command
Format
The ATTN command has the following syntax:
>>----ATTN -------------------------------><
Usage
BRANCH Command
The BRANCH command causes the ACL/E program to branch to a specified line depending on the current value of the condition code.
Format
The attention interrupt is sent to the application regardless of how the Attn key is defined in the users System Options Table.
The BRANCH command has the following syntax:
->>---BRANCH------ ANY, ------------------- label ------><
+- condition code, ---+
Operands
The BRANCH command has the following operands:
Operand Explanation
ANY Makes the BRANCH command branch regardless of the current value of the condition code.
condition code Specifies a possible condition code value. If the condition code set in a previous command matches this value, the BRANCH command branches. Possible condition code values are EQ, NE, GT, LT, LE, or
GE.
label Specifies the program line that the BRANCH command branches to.
You cannot specify a variable in this operand.
124 ACL/E Programming Guide
CLEAR Command
Usage
CLEAR Command
The CLEAR command simulates the pressing of the Clear key and clears the screen. As with all of the action keys (Enter, Clear, PA, and PFn), ACL/E program execution is suspended until a response is received from the application.
Format
The condition code that the BRANCH command acts on is set by the most recent
COMPARE, SEARCH, SEARCHF, SEARCHN, SEARCHWAIT, or HOME statement.
The CLEAR command has the following syntax:
->>---- CLEAR ------------------------------------><
COMMAND Command
The COMMAND command executes a command within an ACL/E program.
Format
The COMMAND command has the following syntax:
->>---- COMMAND ------ 'TPX command' --------------------><
Operands
The COMMAND command has the following operand:
Operand Explanation
TPX command Specifies the command that is executed by the COMMAND command. The command character is automatically supplied by
ACL/E.
Appendix D: Command Summary 125
COMPARE Command
COMPARE Command
The COMPARE command determines the relationship between two operands and sets a condition code based on the results of the comparison.
The COMPARE command can compare:
■
The contents of one of the accumulators (A1 through A4) and the contents of another accumulator
■
The contents of one of the accumulators (A1 through A4) and an integer
■
Two strings
■
A string and a variable.
Format
The COMPARE command has the following syntax:
->>---- COMPARE ------ operand 1 ------ operand 2 ------------><
Operands
The COMPARE command has the following operands:
Operand Explanation
operand 1
operand 2
Specifies one of the two items that are compared by the COMPARE command.
Specifies the item that the item you specified in operand 1 is compared with.
126 ACL/E Programming Guide
DELETE Command
Usage
The condition code set by the COMPARE command determines if a subsequent BRANCH command performs a branch. A BRANCH command should be the next executable statement after the COMPARE command.
The COMPARE command sets one of the following condition codes:
EQ—equal to
NE—not equal to
GT—greater than
LT—less than
LE—less than or equal to
GE—greater than or equal to
You can use substring notation when specifying a string as an operand in the COMPARE statement. See the chapter "Defining and Manipulating Variables."
DELETE Command
The DELETE command simulates the pressing of the Delete key. It deletes the character at the cursor position and shifts the remaining data in the field one space to the left.
Format
The DELETE command has the following syntax:
->>---- DELETE ------------------------------------><
DISPLAY Command
The DISPLAY command displays an alternate screen image.
Format
The DISPLAY command has the following syntax:
>>--- DISPLAY ----- panel name ----------------------------><
+- , varname ---+
Appendix D: Command Summary 127
DOWN Command
Operands
The DISPLAY command has the following operands:
Operand Explanation
panel name
varname
Specifies the alternate screen panel displayed by the DISPLAY command.
Specifies a variable. The cursor is placed in the field associated with this variable.
DOWN Command
The DOWN command moves the cursor down the screen. If the cursor reaches the bottom of the screen, it wraps to the top of the screen and continues downward from there.
Format
The DOWN command has the following syntax:
>>------ DOWN ------
n -------------------------------><
Operands
The DOWN command has the following operand:
Operand Explanation
n Specifies how many lines down the screen the cursor is moved.
ENTER Command
The ENTER command simulates the pressing of the Enter key and transmits screen input data back to the application. As with all of the action keys (Enter, Clear, PA, and PFn), program execution is suspended until a response is received from the application.
128 ACL/E Programming Guide
EOF Command
Format
EOF Command
The EOF command simulates the pressing of the Erase EOF key and replaces all characters on the screen from the cursor to the end of the field with null characters.
Format
The ENTER command has the following syntax:
>>------ ENTER --------------------------------------------><
The EOF command has the following syntax:
>>------ EOF -------------------------------><
GDEFINE Command
The GDEFINE command defines a global variable. This variable can be set or referenced by any program running on this CA-TPX system.
Format
The GDEFINE command has the following syntax:
>>--- GDEFINE --- varname,n --------------------------------------------------><
+-TYPE= ----- ,CHAR ------------------------+
| +- NOTRUNC ----+ |
| |
|-- ,UPCHAR ---------------------|
| +- NOTRUNC ----+ |
| |
|-- ,NUM ------------------------|
|-- ,BIN ------------------------|
+-- ,HEX ------------------------+
Appendix D: Command Summary 129
GDELETE Command
Operands
GDELETE Command
The GDELETE command deletes a global variable.
Format
The GDEFINE command has the following operands:
varname
Specifies the name of the transient variable defined in the GDEFINE command.
n
Specifies thelength of thevariable. Thedefault length iseight.
TYPE=
Specifies the type of variable defined in the UDEFINE command. Must specify CHAR,
UPCHAR, NUM, BIN, or HEX.
CHAR
Indicates that the variable is a character variable.
UPCHAR
Indicates that the variable is an uppercase character variable.
NUM
Indicates that the variable is a numeric variable.
BIN
HEX
Indicates that the variable is a binary variable.
Indicates that the variable is a hexadecimal variable.
NOTRUNC
Indicates that any trailing blanks in the variable will not be deleted when variable substitution takes place. This operand can be used only with the CHAR and UPCHAR operands.
The GDELETE command has the following syntax:
>>------ GDELETE ----- varname ---------------------------><
130 ACL/E Programming Guide
HOME Command
Operands
The GDELETE command has the following operand:
Operand Explanation
varname Specifies the name of the global variable deleted in the GDELETE command.
HOME Command
The HOME command simulates the pressing of the Home key and moves the cursor to the first unprotected input field on the screen.
Format
The HOME command has the following syntax:
>>------ HOME -------------------------------------------><
INPUT Command
The INPUT command suspends operation of the ACL/E program until input is received from the terminal. When input arrives it is merged with the current screen image and execution resumes.
The data received by the INPUT command can by used by subsequent SEARCHN and
SEND commands.
Format
The INPUT command has the following syntax:
>>------ INPUT -----------------------------------------><
INSERT Command
The INSERT command simulates the pressing of the Insert key and places the virtual terminal in INSERT mode. The RESET command takes the terminal out of INSERT mode.
Appendix D: Command Summary 131
KEY Command
Format
KEY Command
The KEY command types a specified string on the screen.
Format
The KEY command has the following syntax:
>>------ KEY ------ string -------------------------------><
+-
'string' -----------------+
|- C ---|
+- X ---+
Operands
The INSERT command has the following syntax:
>>------ INSERT --------------------------------------><
The KEY command has the following operands:
Operand Explanation
string
C
X
Specifies the string that the KEY command displays on the screen. If the string contains spaces or punctuation, or you specify the C or X operands, it must be enclosed in single quotes.
Indicates that the string you specified consists of normal keyboard characters. This is the default.
Specifies that the string you specified consists of hex codes representing EBCDIC characters.
LEFT Command
The LEFT command moves the cursor to the left. If the cursor reaches the left edge of the screen, it wraps around to the right side and continues moving left.
132 ACL/E Programming Guide
LOGOFF Command
Format
The LEFT command has the following syntax:
>>------ LEFT ----- n ------------------------><
Operands
The LEFT command has the following operand:
Operand Explanation
n Specifies how many spaces the cursor is moved.
LOGOFF Command
The LOGOFF command simulates the /K command.
Format
The LOGOFF command has the following syntax:
>>------ LOGOFF -------------------------------------><
Usage
MSG Command
The MSG command writes a string to the message log. This command is helpful in debugging ACL/E programs.
Format
If you have specified K or F in the "Inactivate on" field of the user's definition, the sessions will not be inactivated. In this case you must use COMMAND 'K' or COMMAND
'F' instead of the LOGOFF command.
The MSG command has the following syntax:
>>------ MSG ------
string -------------------------><
+-
'string' ---+
Appendix D: Command Summary 133
NL Command
Operands
The MSG command has the following operand:
Operand Explanation
string Specifies text sent to the CA-TPX message log by the MSG command.
The string can be any text up to 60 characters in length.
NL Command
The NL command simulates the pressing of the Return key and advances the cursor to the first input field after the beginning of the next row on the screen.
Format
The NL command has the following syntax:
>>------ NL ----
n ------------------------------------------><
Operands
The NL command has the following operand:
Operand Explanation
n Specifies how many times the NL command advances the cursor.
NOTIFY Command
The NOTIFY command adds one to the NOTIFY count of an ACL/E program executing in the specified session.
Format
The NOTIFY command has the following syntax:
>>------ NOTIFY ----- sessionID ------------------------><
134 ACL/E Programming Guide
OPTION Command
Operands
The NOTIFY command has the following operand:
Operand Explanation
sessionID Specifies the session containing an executing ACL/E program whose notify count is incremented by the NOTIFY command.
Usage
The NOTIFY command works in conjunction with a SUSPEND command to allow communication between ACL/E programs running in different sessions. When a suspended ACL/E program's NOTIFY count is equal to or greater than its SUSPEND count, the program resumes execution.
For more information, see the SUSPEND command.
OPTION Command
The OPTION command controls various options associated with the execution of ACL/E programs.
Format
The OPTION command has the following syntax:
>>---- OPTION ------- ERROR, -----label ----------------------><
| |
|-- FLOW, ----- ON ------------------|
| +- OFF --+ |
| |
|-- IMAGE, ---- APPL ----------------|
| +- APPL_NOSEND ----+----|
| |
|-- MAXI, ----- n -------------------|
| +- 50 ---+ |
| |
|-- KEYERR, --- ON ------------------|
| +- OFF --+ |
| |
|-- TERM, ----- ON ------------------|
| +- OFF --+ |
| |
|-- TIME= ---- N,label --------------|
| +- OFF --------+ |
| |
+-- RESIDENT, ----- ON --------------+
+- OFF --+
Appendix D: Command Summary 135
OPTION Command
Operands
The OPTION command has the following operands:
Operand Explanation
ERROR, label
FLOW,ON|OFF
Indicates a label at which program execution will continue in case an ACL/E processing error occurs. At the label you can:
Issue the RESUME command to resume execution of the program.
Terminate execution of the program.
Perform other ACL/E processing.
When this operand is used, the variable &ERR_RC is set with the return code of the error, and the variable
&ERR_MSG is set with the text of the error message.
Indicates whether or not the ACL/E program records the sequence of executed commands in the message log. The default is OFF, which prevents commands from being recorded in the log.
IMAGE,APPL|APPL_NOSEND IMAGE,APPL indicates that an alternate image is to be removed from the screen and the application image redisplayed. IMAGE,APPL_NOSEND removes the alternate image, but does not redisplay the application image.
MAXI,n|50 Indicates the total number of statements (n) that can be executed by an ACL/E program. The default is 50.
You can specify an integer between zero and 64,000.
KEYERR,ON|OFF
TERM,ON|OFF
Indicates whether or not the ACL/E program terminates if an error occurs when the program is keying data into an input field. The default is ON, which causes the program to terminate. This operand exists for compatibility with earlier versions of ACL/E, and it is recommended that the ERROR operand be used. KEYERR, OFF overrides the OPTION,ERROR command if a -KEY-OPERATION ENCOUNTERED AN
OUT-OF-BOUNDS CONDITION error occurs.
Indicates whether or not the application data is sent to the terminal during ACL/E program execution. The
default is OFF, which prevents data from being sent.
136 ACL/E Programming Guide
OUTPUT Command
Operand
TIME=N,label
TIME,OFF
RESIDENT,ON|OFF
Explanation
Indicates a time-out value for ACL/E processing. If no activity occurs for the time-out period, the program resumes at the statement marked with the label. N specifies the time-out period in seconds. A value of
OFF prevents the program from timing out.
Prevents the program from timing out.
Indicates whether or not the ACL/E program remains in storage after the program ends. The default is OFF, which prevents the program from being stored.
OUTPUT Command
The OUTPUT command creates an alternate screen image that is a composite of the application screen image and a specified string.
Format
The OUTPUT command has the following syntax:
>>------ OUTPUT ----- string ------------------------------><
+- 'string' --------------------+
|-- ,p -----|
+-- ,r/c --+
Operands
The OUTPUT command has the following operands:
Operand Explanation
string
p
r/c
Specifies the string that the OUTPUT command displays on the application screen image.
Specifies the starting location for the string on the screen as an absolute screen position.
Specifies the starting location for the string on the screen as a row number and column number.
Appendix D: Command Summary 137
OUTPUTC Command
Usage
The default starting location for the string is the location specified in the &LOC variable.
OUTPUTC Command
The OUTPUTC command functions in the same manner as the OUTPUT command, except that it does not refresh the existing screen image. This allows you to place multiple output lines on a single screen image without the old lines being erased.
Format
The OUTPUTC command has the following syntax:
>>------ OUTPUTC ----- string ----------------------------><
+-
'string' --------------------+
|--
,p -----|
+--
,r/c --+
Operands
The OUTPUTC command has the following operands:
Operand Explanation
string
p
r/c
Specifies the string that the OUTPUTC command displays on the application screen image.
Specifies the screen starting location for the string as an absolute screen position.
Specifies the screen starting location for the string as a row number and column number.
Usage
The default screen starting location for the string is the location specified in the &LOC variable.
138 ACL/E Programming Guide
PA Command
PA Command
The PA command simulates the pressing of a PA key. As with all of the action keys
(Enter, Clear, PA, and PFn), ACL/E program execution is suspended until a response is received from the application.
Format
The PA command has the following syntax:
>>------ PA ------
key number ---------------------------><
Operands
The PA command has the following operand:
Operand Explanation
key number Specifies the PA key that the PA command simulates. The key
number must be an integer between one and three.
PAUSE Command
The PAUSE command suspends ACL/E execution to allow the user to press an action key
(Enter, CLEAR, PA, or PFn). This allows the user to perform some action, such as selecting from a menu or entering data before the next ACL/E statement is executed.
The user's action is transmitted to the application, and ACL/E execution resumes when the application responds. This operand exists for compatibility with earlier versions of
ACL/E, and it is recommended that the INPUT statement or a combination of INPUT and
SEND statements be used.
Format
The PAUSE command has the following syntax:
>>------ PAUSE -----------------------------------><
Appendix D: Command Summary 139
PF Command
PF Command
The PF command simulates the pressing of a PF key and transmits all screen input data to the application. As with all of the action keys (Enter, Clear, PA, and PFn), ACL/E program execution is suspended until a response is received from the application.
Format
The PF command has the following syntax:
>>------ PF ------
key number --------------------------><
Operands
The PF command has the following operand:
Operand Explanation
key number Specifies the PF key that the PF command simulates. The key number must be an integer between 1 and 24.
RESET Command
The RESET command simulates the pressing of the Reset key and takes the virtual terminal out of INSERT mode. The INSERT command places the virtual terminal in
INSERT mode.
Format
The RESET command has the following syntax:
>>------ RESET -------------------------------------><
RESUME Command
The RESUME command resumes execution of a program after an ACL/E processing error. The program resumes execution at the line following the statement that caused the error.
This command can be used only in conjunction with an OPTION command with the
ERROR operand.
140 ACL/E Programming Guide
RIGHT Command
Format
RIGHT Command
The RIGHT command simulates the pressing of the right arrow key. If the cursor reaches the right edge of the screen, it wraps around to the left side and continues moving right.
Format
The RESUME command has the following syntax:
>>------ RESUME ------------------------------------><
The RIGHT command has the following syntax:
>>------ RIGHT ------
n ----------------------------><
Operands
The RIGHT command has the following operand:
Operand Explanation
n Specifies how many times the RIGHT command advances the cursor.
SCAN Command
The SCAN command searches a specified string for another specified string of characters. If it finds the string it is looking for, the SCAN command sets the condition code to EQ. If the string is not found it is set to NE.
Format
The SCAN command has the following syntax:
>>-- SCAN - string -- ,target string ------------------------><
+--,START= -- n --+
Appendix D: Command Summary 141
SEARCH Command
Operands
The SCAN command has the following operands:
Operand Explanation
string
target string
,START=n
Specifies the string that the SCAN command searches for the target string.
Specifies the string that the SCAN command searches for within the specified string.
Specifies the character position within the search string at which the SCAN command starts looking for the target string. The default value is zero (0).
SEARCH Command
The SEARCH command searches the screen either for a specified string of characters or for any non-null or non-blank data. If it finds what it is looking for, the SEARCH command sets the condition code to EQ.
Format
The SEARCH command has the following syntax:
>>--- SEARCH ------ ANY -----------------------------------><
+----- string ----------------------+
+--
'string' --+ |-- C --|
+-- X --+
Operands
The SEARCH command has the following operands:
Operand Explanation
ANY Sets a condition code of EQ if the SEARCH command finds any non-null or non-blank data on the screen.
string
C
Specifies the string that the SEARCH command searches for on the screen. If the string contains any punctuation marks or spaces, or you specify the C or X operand, it must be enclosed with single quotes.
Indicates that the string you specify consists of normal keyboard characters. This is the default.
142 ACL/E Programming Guide
SEARCHF Command
Operand
X
Explanation
Indicates that the string you specify consists of hexadecimal codes.
Usage
A BRANCH statement should always be the next executable statement after the SEARCH statement.
SEARCHF Command
The SEARCHF command searches an area of the screen image, starting at the screen position specified in the &LOC variable and ending at the end of the current field. If it finds what it's looking for, the SEARCH command sets the condition code to EQ.
Format
The SEARCHF command has the following syntax:
>>-- SEARCHF ------ ANY -------------------------------------><
+----- string -----------------------+
+--
'string' --+ |-- C --|
+-- X --+
Operands
The SEARCHF command has the following operands:
Operand Explanation
ANY
string
C
X
Sets a condition code of EQ if the SEARCHF command finds any non-null or non-blank data on the screen.
Specifies the string that the SEARCHF command searches for on the screen. If the string contains any punctuation marks or spaces, or you use the C or X operand, it must be enclosed with single quotes.
Indicates that the string you specified consists of normal keyboard characters. This is the default.
Indicates that the string you specified consists of hexadecimal codes representing EBCDIC characters.
Appendix D: Command Summary 143
SEARCHN Command
Usage
The SEARCHF command is often used after a successful SEARCH operation, because the
&LOC variable is set by the SEARCH command.
A BRANCH command should be the first executable statement following the SEARCHF command.
SEARCHN Command
The SEARCHN command searches the data received by the immediately preceding
INPUT statement and sets a condition code of EQ if it finds what it is looking for.
Format
The SEARCHN command has the following syntax:
>>--- SEARCHN ---- ANY --------------------------------------><
+----- string -------------------------+
+--
'string' --+ |-- C --|
+-- X --+
Operands
The SEARCHN command has the following operands:
Operand Explanation
ANY
string
C
X
Sets a condition code of EQ if the SEARCHN command finds any non-null or non-blank data on the screen.
Specifies the string that the SEARCHN command searches for on the screen. If the string contains any punctuation marks or spaces, or you specify the C or X operand, it must be enclosed with single quotes.
Indicates that the string you specified consists of normal keyboard characters. This is the default.
Indicates that the string you specified consists of hexadecimal codes representing EBCDIC characters.
Usage
A BRANCH statement should always be the next executable statement after the
SEARCHN statement.
144 ACL/E Programming Guide
SEND Command
SEND Command
The SEND command sends all modified fields in the screen image and the current
Attention Identifier (AID) to the application.
Format
The SEND command has the following syntax:
>>---- SEND ---------------------------------><
Usage
This command allows an ACL/E program to send data to the application after receiving it from the user with an INPUT statement.
The current AID is contained in the &TAID variable. If you want to send a value other than the current value, use the ACL/E command that performs the action you want (for example, the ENTER or PFn commands). You can use the SET statement to set the value of &TAID to an action key and then use the SEND command.
SET Command
The SET command can set the value of an accumulator, the &CURSOR or &LOC variable, or a user defined variable.
Format
The SET command has the following syntax:
>>-- SET ---- accumulator 1 -----------accumulator 2 ---------><
| +-- n ---------------+ |
| |
|------ CURSOR, -------- p ---------------------|
| +- LOC, -----+ +- rlc ---+ |
| |
+------ uservar ----- string -------------------|
+- 'string' ---+
Appendix D: Command Summary 145
SIGNOFF Command
Operands
The SET command has the following operands:
Operand Explanation
accumulator 1 Specifies the accumulator whose contents is set by the SET command.
accumulator 2 Specifies the accumulator whose value is assigned to the accumulator you specified in accumulator 1.
n Specifies an integer value assigned to the accumulator specified in
accumulator 1.
CURSOR
LOC
p
r/c
uservar
string
Assigns a specified screen location to the &CURSOR variable.
Assigns a specified screen location to the &LOC variable.
Specifies a screen location as an absolute screen position.
Specifies a screen location as a row and column number.
Specifies a user defined variable whose contents is set by the SET command.
Specifies a string assigned to the uservar you specified in the SET command.
SIGNOFF Command
The SIGNOFF command simulates the CA-TPX /F command.
Format
The SIGNOFF command has the following syntax:
>>---- SIGNOFF ----------------------------------------><
Usage
If you have specified F in the "Inactivate on" field of the user's definition, the sessions will not be inactivated by the SIGNOFF command. In this case you must use COMMAND
'F' instead of the SIGNOFF command.
146 ACL/E Programming Guide
SRCHWAIT Command
SRCHWAIT Command
The SRCHWAIT command passes control to the next ACL/E instruction only if one of the following conditions occur:
■
The specified string is found.
■
In this case the condition code is set to EQ.
The SNA RU indicates an "IN-BRACKET" state with the terminal owning direction and no data being sent by the application.
In this case the condition code is set to NE.
Format
The SRCHWAIT command has the following syntax:
>>---- SRCHWAIT ----------- string --------------------><
+--
'string' --+
Operands
The SRCHWAIT command has the following operand:
Operand Explanation
string Specifies the string that the SRCHWAIT command looks for.
Usage
The SRCHWAIT command combines the features of the SEARCH and WINP commands, and is intended to be used in an environment such as VM, CA-Remote Console,
OMEGAMON or NetView, in which unsolicited RUs are arriving from the application.
STOP Command
The STOP command terminates execution of the ACL/E program. This command is not necessary at the end of the program, but can be used to terminate execution at some other place in the program.
Appendix D: Command Summary 147
SUB Command
Format
SUB Command
The SUB command subtracts a value from one of the four accumulators (A1 through
A4).
Format
The STOP command has the following syntax:
>>---- STOP ---------------------------------------------><
The SUB command has the following syntax:
>>--- SUB --- accumulator 1 --------accumulator 2 ----------><
|-- n ---------------|
+-- variable --------+
Operands
The SUB command has the following operands:
Operand Explanation
accumulator 1
accumulator 2
n
variable
Specifies the accumulator to be decremented.
Specifies the accumulator whose value is subtracted from the accumulator specified in accumulator 1.
Specifies an integer that is subtracted from the accumulator specified in accumulator 1.
Specifies a numeric variable that is subtracted from the accumulator specified in accumulator 1.
SUSPEND Command
The SUSPEND command adds a specified number to the current SUSPEND count and suspends ACL/E execution if the new SUSPEND count is greater than the current NOTIFY count. Execution continues when enough NOTIFY events are received from other ACL/E programs to make the NOTIFY count greater than or equal to the SUSPEND count.
148 ACL/E Programming Guide
TABB Command
Format
The SUSPEND command has the following syntax:
>>---- SUSPEND ------- n ------------------------------><
Operands
The SUSPEND command has the following operand:
Operand Explanation
n Specifies the number added to the SUSPEND count.
Usage
The SUSPEND count is contained in the &SUSPNDCT variable and the NOTIFY count is contained in the &NOTIFYCT variable.
It is a good idea to use an OPTION TIME= statement in your program in case the ACL/E program issuing the NOTIFY events fails.
TABB Command
The TABB command simulates the back tab key and moves the cursor to the beginning of the current input field (if it is in an input field) and then to previous input fields. The cursor is always moved to the first position of the last input field it has moved to.
Format
The TABB command has the following syntax:
>>---- TABB ------- n ---------------------------------><
Operands
The TABB command has the following operand:
Operand Explanation
n Specifies how many times the TABB command moves the cursor.
Appendix D: Command Summary 149
TABF Command
TABF Command
The TABF command moves the cursor forward a specified number of input fields. The cursor is moved to the first position of the target field.
Format
The TABF command has the following syntax:
>>---- TABF ------- n ---------------------------------><
Operands
The TABF command has the following operand:
Operand Explanation
n Specifies how many times the TABF command moves the cursor.
TABL Command
The TABL command moves the cursor to the last input field on the current screen.
Format
TERMSESS Command
The TERMSESS command immediately terminates the application session associated with the executing program. This command can be used in an ACL/E logoff program when unexpected conditions arise.
Format
The TABL command has the following syntax:
>>---- TABL ---------
----------------------------------><
The TERMSESS command has the following syntax:
>>---- TERMSESS ---------------------------------------><
150 ACL/E Programming Guide
UDEFINE Command
UDEFINE Command
The UDEFINE command defines a user-level (persistent) variable. This variable can be set or referenced by any ACL/E program on any session belonging to this CA-TPX user but is deleted when the user signs off.
Format
The UDEFINE command has the following syntax:
>>---- UDEFINE --- varname,n --------------------------------------------------->
<
+-TYPE= ----- CHAR ------------------------+
| +- NOTRUNC ----+ |
| |
|-- UPCHAR ---------------------|
| +- NOTRUNC ----+ |
| |
|-- NUM ------------------------|
|-- BIN ------------------------|
+-- HEX ------------------------+
Operands
The UDEFINE command has the following operands:
Operand Explanation
varname Specifies the name of the transient variable defined in the UDEFINE command.
n
TYPE=
Specifies the length of the variable. The default length is eight.
Specifies the type of variable defined in the UDEFINE command.
Must specify CHAR, UPCHAR, NUM, BIN, or HEX.
CHAR
UPCHAR
NUM
BIN
HEX
NOTRUNC
Indicates that the variable is a character variable.
Indicates that the variable is an uppercase character variable.
Indicates that the variable is a numeric variable.
Indicates that the variable is a binary variable.
Indicates that the variable is a hexadecimal variable.
Indicates that any trailing blanks in the variable will not be deleted when variable substitution takes place. This operand can be used only with the CHAR and UPCHAR operands.
Appendix D: Command Summary 151
UDELETE Command
UDELETE Command
The UDELETE command deletes a user-level variable.
Format
The UDELETE command has the following syntax:
>>------ UDELETE ----- varname --------------------><
Operands
The UDELETE command has the following operand:
Operand Explanation
varname Specifies the name of the user-level variable deleted by the UDELETE command.
UP Command
The UP command moves the cursor up the screen. If the cursor reaches the top of the screen, it wraps and continues upwards from the bottom of the screen.
Format
The UP command has the following syntax:
>>------ UP ------
n --------------------------------><
Operands
The UP command has the following operand:
Operand Explanation
n Specifies how many lines the cursor is moved by the UP command.
152 ACL/E Programming Guide
VDEFINE Command
VDEFINE Command
The VDEFINE command defines an ACL/E-level (transient) variable. This variable can be set or referenced by programs called by the current ACL/E program but is automatically deleted when the current program terminates.
Format
The VDEFINE command has the following syntax:
>>-- VDEFINE --- varname,n ----------------------------------------------------><
+-TYPE= ----- CHAR -------------------------+
| +- NOTRUNC ----+ |
| |
|-- UPCHAR ----------------------|
| +- NOTRUNC ----+ |
| |
|-- NUM -------------------------|
|-- BIN -------------------------|
+-- HEX -------------------------+
Operands
The VDEFINE command has the following operands:
Operand Explanation
varname
n
TYPE=
CHAR
UPCHAR
NUM
BIN
HEX
NOTRUNC
Specifies the name of the transient variable defined in the VDEFINE command.
Specifies the length of the variable. The default length is eight.
Specifies the type of variable defined in the VDEFINE command.
Must specify CHAR, UPCHAR, NUM, BIN, or HEX.
Indicates that the variable is a character variable.
Indicates that the variable is an uppercase character variable.
Indicates that the variable is a numeric variable.
Indicates that the variable is a binary variable.
Indicates that the variable is a hexadecimal variable.
Indicates that any trailing blanks in the variable will not be deleted when variable substitution takes place. This operand can be used only with the CHAR and UPCHAR operands.
Appendix D: Command Summary 153
VDELETE Command
VDELETE Command
The VDELETE command deletes a transient variable.
Format
The VDELETE command has the following syntax:
>>------ VDELETE ----- varname -------------------------><
Operands
The VDELETE command has the following operand:
Operand Explanation
varname Specifies the name of the transient variable deleted in the VDELETE command.
WAIT Command
The WAIT command suspends program execution for a specified number of seconds.
Output from the application still appears on the screen during this period if OPTION
TERM is set to ON.
Format
The WAIT command has the following syntax:
>>------ WAIT ----- n -----------------------------------><
Operands
The WAIT command has the following operand:
Operand Explanation
n Specifies how many seconds the WAIT command suspends program execution.
154 ACL/E Programming Guide
WINP Command
WINP Command
The WINP command causes the ACL/E program to wait for data from the application.
Format
The WINP command has the following syntax:
>>------ WINP --------------------------------------><
Appendix D: Command Summary 155
Appendix E: Predefined Variables
This appendix lists the ACL/E predefined variables and their attributes.
For a list of all variables that do not have operands, see the
Predefined Variables
page 157) table in this chapter. For a list of variables that return information about a
user-specified session or application, see the
Predefined Function Variables
page 161) table in this chapter. The variables are listed in alphabetical order.
This section contains the following topics:
Predefined Variables
Predefined Function Variables
Predefined Variables
The following table lists the ACL/E predefined variables that do not require an operand.
Variable Function
&An
&AID
&APPL
&APPLID
&CSRCOL
&CSRROW
This variable represents any of four accumulators, &A1 through
&A4, which can contain any positive integer from 0 through
16,777,215 (16M-1). Accumulators can be set, added into, subtracted from, and compared against other values, or included in any string as &An (where n equals 1, 2, 3, or 4).
When used in a string this way (for example, 487&A1.ABC), the value of &A1 is substituted into the string before the statement is executed. For instance, if &A1=333 in the last example, the value of the string would be 487333ABC.
This variable represents the attention identifier byte from the last action taken.
This variable represents the VTAM APPLID of the session in which the ACL/E is running.
This variable represents the VTAM APPLID of the session in which the ACL/E is running. For applications that issue CLSDST PASS, such as TSO, this variable can have a different value than &APPL.
This variable represents the column value of the &CURSOR variable.
This variable represents the row value of the &CURSOR variable.
Appendix E: Predefined Variables 157
Predefined Variables
Variable
&CURSOR
&ERR_MSG
&ERR_RC
&IPADDR
&IPPORT
&IPVECT
&LOC
&LOCCOL
&LOCROW
&NETNAME
&NPSWD
&NPWPH
&OPSWD
Function
This variable represents the current cursor location as a screen position. Row 1, Column 1 is position 1. On an 80 by 24 display,
Row 2, Column 1 is position 81, and so on. Use of &CURSOR as the receiving field of a SET command causes cursor movement within the current screen image.
This variable contains the text of the error message that occurred during ACL/E processing, and is set when you use the ERROR operand on the OPTION command.
This variable contains the return code of the error that occurred during ACL/E processing, and is set when you use the ERROR operand on the OPTION command.
This variable represents either an IPv4 or IPv6 TCP/IP address. If this is an IPv4 address, it will be represented as a 4 octet address.
If this is an IPv6 address, it will be represented as an 8, 16 bit, hexadecimal value address.
This variable represents the 1 to 4 byte TCP/IP port number of the terminal connection, in decimal. Leading zeroes are suppressed.
This variable represents the entire TCP/IP vector (x'64') from the
CINIT.
This variable represents a data location as a screen position. Row
1, column 1 is position 1. The SEARCH command sets &LOC to the screen position of the first byte of data that satisfies an equal condition.
&LOC is used to determine the current field location for
&SCRNFLD and for SEARCHF.
This variable contains the column value of the &LOC variable.
This variable contains the row value of the &LOC variable.
This variable represents the VTAM network name of the physical terminal where the current application session is active.
This variable represents the new password the user defined after signing on. If the user kept the initial password, CA TPX assigns a value of two question marks (??) to this variable.
This variable represents the new password phrase the user defined after signing on. If the user kept the initial password phrase, CA TPX assigns a value of two question marks (??) to this variable.
This variable represents the password that the user initially employed when signing on to CA TPX.
158 ACL/E Programming Guide
Predefined Variables
Variable
&OPWPH
&Pn
&PRINTER
&PSWD
&PWPH
&SCREEN
&SCRNCOLS
&SCRNFLD
&SCRNROWS
&SCRNSIZE
&SID
Function
This variable represents the password phrase that the user initially employed when signing on to CA TPX.
These variables, &P1 through &P8, represent the respective items in the PARM parameter statement associated with this session, through User or Profile Maintenance. You also can use these variables as string variables or even as return codes by setting them as desired. As with all variables, you can include &Pn variables within a string, and their values will be substituted before the statement is executed.
&P0 has a special meaning. When you start an ACL/E program with the /S command, you can enter text to the right of the ACL/E program name. This text will become &P0 within the program. For example:
/S ACCTACL DEPARTMENT A
&P0 was given the value DEPARTMENT A.
If &P variables are unused, they have a value of eight question marks.
This is the eight-character name of the default printer for the owner of the session in which the ACL/E is running.
This variable represents the current password for the user.
CA TPX assigns a value of two question marks (??) if "NONE" is specified in the "Security System" field in user maintenance.
TPX will pass either a password or password phrase when PSWD is used in an ACL, based upon what is in the user’s control record.
This variable represents the current password phrase for the user.
CA TPX assigns a value of two question marks (??) if "NONE" is specified in the "Security System" field in user maintenance.
This variable represents the entire screen image. It is usually used with substring notation to limit the amount of data involved.
This is the number of columns on the terminal screen.
This variable represents the data from &LOC to the end of the current field.
This is the number of rows on the terminal screen.
This is the absolute screen size, in bytes. For example, 80 columns by 24 rows gives &SCRNSIZE a value of 1920.
This variable represents the session ID of the current session.
Appendix E: Predefined Variables 159
Predefined Variables
&USERID
&VTERM
&ZAPPLID
&ZCONN
&ZDATE
&ZEDATE
&ZJDATE
&ZLDATE
&ZLEDATE
&ZLJDATE
&ZMODEL
&ZNEWS1
&ZNEWS2
&ZSMFID
Variable
&TAID
&TCSRCOL
&TCSRROW
&TCURSOR
Function
This is the last AID (attention identifier) byte received from the terminal in response to the last ACL/E INPUT command.
&TAID defaults to ENTER if no INPUT command has been issued.
You can use the SET command to assign any valid AID value
(PF1-24, CLEAR, PA1-3, or ENTER) to &TAID prior to issuing a SEND command.
This variable represents the column value of &TCURSOR.
This variable represents the row value of &TCURSOR.
This variable represents the current cursor location of the alternate screen image as a screen position. Row 1, column 1 is position 1. On an 80 by 24 display, row 2,column 1 is position 81, and so on.
This variable represents either the user's signon ID or the value specified in the "ACL Userid" field in User or Profile Maintenance.
This variable represents the name of the virtual terminal associated with the session.
This variable represents the VTAM name (applid) of the current
CA TPX.
This variable represents the session ID of the currently connected session (the session currently being displayed on the terminal).
This variable represents the U.S. format date (mm/dd/yy).
This variable represents the European format date (dd/mm/yy).
This variable represents the Julian format date (yyddd).
This variable represents the U.S. long format date (mm/dd/yyyy).
This variable represents the European long format date
(dd/mm/yyyy).
This variable represents the Julian long format date (yyyyddd).
This variable represents the terminal model type (for example,
3278-2).
This variable is used on the LOGO panel for distributing a brief message to users.
This variable is used on the LOGO panel for distributing a brief message to users.
This variable represents the SMF ID of the z/OS system running CA
TPX. This is a system parameter for GCS.
160 ACL/E Programming Guide
Predefined Function Variables
Variable
&ZSYSID
&ZTIME
&ZTERMID
Function
This variable represents the name of the System Options Table
(SMRT) currently in use by CA TPX.
This variable represents the current time.
This variable represents VTAM Terminal ID.
Predefined Function Variables
The following table lists the ACL/E predefined variables that are functions that return information about a user-specified session or application.
Variable Function
&APPL_INF(applID) This variable provides information about the specified application. The variable can return one or more of the following values:
ACTIVE—Indicates that the application is defined and is accepting logons.
INACT—Indicates that the application is defined but is not accepting logon.
QUIESCED—Indicates that the application has one or more active sessions. New sessions will not be started.
TYPE=TPX—Indicates that the application is an internal application such as TPXMAIL or TPXVIEW.
UNDEFINED—Indicates that the application is not defined to CA
TPX.
&MSIZE_OF(string) This variable represents the maximum possible length of the specified string after variables in the string have been substituted.
Appendix E: Predefined Variables 161
Predefined Function Variables
Variable Function
&SESS_INF(sessionI
D)
This variable represents information about the specified session.
It can return one or more of the following values:
ACTIVE—Indicates that the session is currently active.
ACL=program—Indicates that the session is active and the specified ACL/E program is running in the session.
APPL=appl—Indicates that the specified application is running the session.
CURRENT—Indicates that the session is the user's current session.
INACT—Indicates that the session is not currently active, although it has been active during the user's current session with
CA TPX.
NEVACT—Indicates that the session has never been active during the user's current session with CA TPX.
UNDEFINED—The specified session is not a valid session name.
&SIZE_OF(string) This variable represents the length of the specified string after all variables in that string have been substituted.
&TYPE_OF(variable
)
This variable represents the specified variable's type. This variable can return one or more of the following values:
ACL—Indicates that the variable was defined in ACL/E.
ARRAY—Indicates that this is an array variable.
BIN—Indicates that this is a binary variable.
CHAR—Indicates that this is a character variable.
HEX—Indicates that this is a hexadecimal variable.
NOTRUNC—Indicates that the variable will not be stripped of trailing blanks when substitution takes place.
NUM—Indicates that this is a numeric variable.
UNDEFINED—Indicates that the variable is not defined.
UPCHAR—Indicates that this is an uppercase character variable.
162 ACL/E Programming Guide
Appendix F: Return Codes
This appendix lists the ACL/E return codes that are issued when an ACL/E processing error occurs.
This section contains the following topics:
Return Codes and Messages
Return Codes and Messages
When you use the OPTION statement with the ERROR operand, the variable &ERR_RC is set to the value of the return code and the variable &ERR_MSG is set to the value of the corresponding message text.
Return Code List
The following table lists the ACL/E return codes that are issued when an ACL/E processing error occurs. When you use the OPTION statement with the ERROR operand, the variable &ERR_RC is set to the value of the return code and the variable &ERR_MSG is set to the value of the corresponding message text.
Return Code Message Text
RC_01
RC_02
RC_03
SCRIPT EXCEEDED INSTRUCTION EXECUTION LIMIT
NO OPCODE ENCOUNTERED IN STATEMENT
STATEMENT CONTAINS AN INVALID OPCODE
-ADD- OPERATION CONTAINED INVALID OPERAND 1
RC_04
RC_05
RC_06
RC_07
RC_08
-ADD- OPERATION CONTAINED INVALID OPERAND 1
-ADD- OPERATION CONTAINED INVALID OPERAND 2
-ADD- OPERATION CONTAINED INVALID OPERAND 2
-ADD- OPERATION CONTAINED INVALID OPERAND 2
RC_09
RC_10
RC_11
RC_12
-BRANCH- OPERATION CONTAINED AN INVALID OPERAND 1
-BRANCH- OPERATION CONTAINED AN INVALID OPERAND 2
-BRANCH- OPERATION CONTAINED AN INVALID OPERAND 2
-BRANCH- OPERATION CONTAINED AN INVALID OPERAND 2
Appendix F: Return Codes 163
Return Codes and Messages
Return Code
RC_28
RC_29
RC_30
RC_31
RC_32
RC_33
RC_34
RC_35
RC_36-RC_39
RC_40
RC_41
RC_42
RC_43
RC_44
RC_45
RC_20
RC_21
RC_22
RC_23
RC_24
RC_25
RC_26
RC_27
RC_13
RC_14
RC_15
RC_16
RC_17
RC_18
RC_19
Message Text
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 1
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 1
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 1
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 2
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 2
-COMPARE- OPERATION CONTAINED AN INVALID OPERAND 2
UNUSED
-DOWN- OPERATION CONTAINED AN INVALID OPERAND 1
-DOWN- OPERATION CONTAINED AN INVALID OPERAND 2
UNUSED
UNUSED
OPERATION CONTAINED AN INVALID OPERAND 1
-KEY- OPERATION ENCOUNTERED AN OUT-OF-RANGE CONDITION
-LEFT- OPERATION CONTAINED AN INVALID OPERAND 1
-LEFT- OPERATION CONTAINED AN INVALID OPERAND 1
-MSG- OPERATION CONTAINED AN INVALID OPERAND 1
-OPTION- OPERATION CONTAINED AN INVALID OPERAND 1
-OPTION- OPERATION CONTAINED AN INVALID OPERAND 2
-OPTION- OPERATION CONTAINED AN INVALID OPERAND 2
-OPTION- OPERATION CONTAINED AN INVALID OPERAND 2
-OPTION- OPERATION CONTAINED AN INVALID OPERAND 2
-PA- OPERATION CONTAINED AN INVALID OPERAND 1
-PA- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-PF- OPERATION CONTAINED AN INVALID OPERAND 1
-PF- OPERATION CONTAINED AN INVALID OPERAND 1
-RIGHT- OPERATION CONTAINED AN INVALID OPERAND 1
-RIGHT- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-SCRIPT- OPERATION CONTAINED AN INVALID OPERAND 1
164 ACL/E Programming Guide
Return Codes and Messages
Return Code
RC_68
RC_69
RC_70
RC_71
RC_72
RC_73
RC_74
RC_75
RC_60
RC_61
RC_62
RC_63
RC_64
RC_65
RC_66
RC_67
RC_52
RC_53
RC_54
RC_55
RC_56
RC_57
RC_58
RC_59
RC_46
RC_47
RC_48
RC_49
RC_50
RC_51
Message Text
-SCRIPT- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-SEARCH- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-SET- OPERATION CONTAINED AN INVALID OPERAND 1
-SET- OPERATION CONTAINED AN INVALID OPERAND 1
-SET- OPERATION CONTAINED AN INVALID OPERAND 2
-SET- OPERATION CONTAINED AN INVALID OPERAND 2
-SET- OPERATION CONTAINED AN INVALID OPERAND 2
VARIABLE SUBSCRIPT TOO LARGE OR NON-NUMERIC
UNUSED
UNUSED
SCRIPT TERMINATED DUE TO RUNAWAY CONDITION
ACL TIMEOUT ERROR - INVALID SB POINTER IN SEB
-SUB- OPERATION CONTAINED AN INVALID OPERAND 1
-SUB- OPERATION CONTAINED AN INVALID OPERAND 1
-SUB- OPERATION CONTAINED AN INVALID OPERAND 2
-SUB- OPERATION CONTAINED AN INVALID OPERAND 2
-SUB- OPERATION CONTAINED AN INVALID OPERAND 2
UNUSED
-UP- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-UP- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-EOF- OPERATION ENCOUNTERED OUT-OF-RANGE CONDITION
-DELETE- OPERATION ENCOUNTERED OUT OF RANGE CONDITION
-EOF- TRIED DOING EOF ON A PROTECTED FIELD
UNUSED
-OPTION- TIMEOUT VALUE IS NOT NUMERIC
-OPTION- TIMEOUT ADDRESS IS NOT A VALID LABEL
Appendix F: Return Codes 165
Return Codes and Messages
Return Code
RC110
RC111
RC112
RC113
RC114
RC115
RC116
RC117
RC102
RC103
RC104
RC105
RC106
RC107
RC108
RC109
RC_76-RC_85
RC_86
RC_87
RC_88
RC_89
RC_90
RC_91
RC_92-RC_95
RC_96
RC_97
RC_98
RC_99
RC100
RC101
Message Text
UNUSED
-TABF- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-TABF- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-COMMAND- OPERAND-1 IS NOT A VALID TPX COMMAND
-COMMAND- OPERAND-1 IS NOT A VALID TPX COMMAND
UNUSED
-TABB- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-TABB- OPERATION CONTAINED AN INVALID OPERAND 1
ACLPGM STARTED ANOTHER ACLPGM FOR INVALID SESSION
UNUSED
-DISPLAY- PANEL VIOLATES NAMING CONVENTIONS
-DISPLAY- PANEL NAME NOT FOUND IN LIBRARY
-DISPLAY- PANEL NOT BUILT DUE TO DEFINITION ERRORS
-*DEFINE- OPERAND-1 INVALID
-*DEFINE- OPERAND-2 INVALID
-*DEFINE- OPERAND-2 IS NOT NUMERIC
-*DEFINE- OPERATION FAILED
-BRANCH- OPERATION CONTAINED AN INVALID OPERAND 1
UNUSED
-*DELETE- OPERAND-1 INVALID
-*DELETE- OPERATION FAILED
-NL- OPERATION CONTAINED AN INVALID OPERAND 1
-NL- OPERATION CONTAINED AN INVALID OPERAND 1
-OPTION- OPERAND-1 INVALID
OPERAND-2 INVALID
-SET- INVALID ROW/COLUMN SPECIFICATION
OPERAND-1 IS NOT NUMERIC
166 ACL/E Programming Guide
Return Codes and Messages
Return Code
RC118
RC119
RC120
RC121
RC122
RC123
RC124
RC125
RC126
RC127-RC255
Message Text
OPERAND-1 INVALID
OPERAND-2 INVALID
-NOTIFY- OPERAND-1 IS NOT A VALID SESSION NAME
-NOTIFY- OPERAND-1 IS NOT AN ACTIVE SESSION
****** ACL/E FUNCTIONS NOT AUTHORIZED ******
UNUSED
-SUBSTRING- NON-NUMERIC VALUE SPECIFIED
-VARIABLE RESOLUTION OVERFLOW. CALL TPX SUPPORT.
SMRT OPTION 22 DOES NOT ALLOW ACL ON SMV1 SESSION
UNUSED
Appendix F: Return Codes 167
Index
&
&AID variable • 157
&An variables • 157
&APPL variable • 65, 67, 157
&APPL_INF(applID) variable • 68, 161
&APPLID variable • 157
&CSRCOL variable • 79, 157
&CSRROW variable • 157
&CURSOR variable • 79, 157
&ERR_MSG variable • 157
&ERR_RC variable • 157
&IPADDR variable • 157
&IPPORT variable • 157
&IPVECT variable • 157
&LOC variable • 78, 157
&LOCCOL variable • 78, 157
&LOCROW variable • 78, 157
&MSIZE_OF(string) variable • 161
&NETNAME variables • 157
&NPSWD variable • 157
&OPSWD variable • 157
&P1-&P8 variables • 157
&PRINTER variable • 157
&PSWD variable • 157
&SCREEN variable • 77, 157
&SCRNCOLS variable • 41, 77, 157
&SCRNROWS variable • 41, 77, 157
&SCRNSIZE variable • 77, 157
&SESS_INF(sessionID) variable • 68, 161
&SID variable • 65, 67, 157
&SIZE_OF(string) variable • 161
&TAID variable • 36, 157
&TCSRCOL variable • 157
&TCSRROW variable • 95, 157
&TCURSOR variable • 95, 157
&TYPE_OF(variable) variable • 161
&USERID variables • 157
&VTERM variable • 157
&ZAPPLID variable • 157
&ZCONN variable • 157
&ZDATE variable • 157
&ZEDATE variable • 157
&ZJDATE variables • 157
&ZLDATE variable • 157
&ZLEDATE variable • 157
&ZLJDATE variables • 157
&ZMODEL variable • 157
&ZSMFID variable • 157
&ZSYSID variable • 157
&ZTIME variables • 157
/
/F command • 59
/K command • 59, 116
A
absolute screen size • 41, 77 accumulators • 20
ACLPGM command • 43, 60, 115, 122
ADD command • 123 alternate screen image • 36 ampersands in ACL/E variables • 85
ATTN command • 73, 114, 123
B
BRANCH command • 30, 32, 36, 51, 54, 115, 124
C
case conversion • 100
CB0VSCRI data set • 16
CLEAR command • 28, 69, 114, 125
COMMAND command • 57, 58, 116, 125 examples • 58 format of • 57, 116, 125 commands • 24, 25, 28, 29, 30, 32, 33, 36, 40, 41, 43,
45, 46, 50, 51, 54, 57, 58, 59, 60, 61, 69, 70, 71,
72, 73, 78, 79, 80, 81, 83, 89, 91, 93, 94, 98, 113,
114, 115, 116, 117, 122, 123, 124, 125, 126, 127,
128, 129, 131, 132, 133, 134, 135, 137, 138, 139,
140,141, 142, 143, 144, 145, 146, 147, 148, 149,
150, 151, 152, 153, 154, 155
ACLPGM • 43, 60, 115, 122
ADD • 115, 123
ATTN • 73, 114
BRANCH • 30, 32, 36, 51, 54, 115, 124
CLEAR • 28, 69, 114, 125
COMMAND • 57, 58, 59, 116, 125
COMPARE • 30, 36, 45, 51, 115, 126
Index 169
DELETE • 127
DISPLAY • 127
DOWN • 79, 114, 128
ENTER • 33, 69, 114, 128
EOF • 83, 113, 129
ERASE • 83, 113
GDEFINE • 41, 89, 116, 129
GDELETE • 91, 116
HOME • 80, 114, 131
INPUT • 36, 71, 115, 131
INSERT • 113, 131
KEY • 33, 81, 113, 132
LEFT • 79, 114, 132
LOGOFF • 59, 116, 133
MSG • 61, 116, 133
NL • 80, 114, 134
NOTIFY • 98, 117, 134
OPTION • 29, 32, 40, 61, 115, 116, 117, 135
OUTPUT • 93, 117, 137
OUTPUTC • 94, 117, 138
PA • 114, 139
PAUSE • 72, 139
PF • 69, 114, 140
RESET • 113, 140
RESUME • 140
RIGHT • 79, 114, 141
SCAN • 115, 141
SEARCH • 32, 54, 78, 113, 142
SEARCHF • 78, 113, 143
SEARCHN • 72, 113, 144
SEND • 72, 114, 145
SET • 114, 115, 116, 145
SIGNOFF • 59, 116, 146
SRCHWAIT • 71, 115, 147
STOP • 24, 25, 115, 147
SUB • 50, 115, 148
SUSPEND • 98, 117, 148
TABB • 46, 81, 114, 149
TABF • 45, 81, 114, 150
TABL • 114
TERMSESS • 58, 73, 115, 150
UDEFINE • 41, 89, 116, 151
UDELETE • 91, 116, 152
UP • 79, 114, 152
VDEFINE • 41, 89, 116, 153
VDELETE • 91, 116, 154
WAIT • 69, 115, 154
WINP • 32, 70, 155
COMPARE command • 30, 36, 45, 51, 115, 126
170 ACL/E Programming Guide
concatentation character in ACL/E variables • 85 condition codes • 20 conventions used in guide • 16 cursor • 78, 79, 94, 95, 100, 107, 114 identifying its position • 78, 95 moving • 79, 114 positioning • 94, 100 sensitive help program • 107
D
debugging ACL/E programs • 61
DELETE command • 127 delimiters in ACL/E variables • 85
DISPLAY command • 127
DOWN command • 79, 114, 128
E
ENTER command • 33, 69, 114, 128
EOF command • 83, 113, 129
ERASE command • 83, 113 executing ACL/E programs • 15, 59, 60
G
GDEFINE command • 41, 89, 116, 129
GDELETE command • 91, 116
H
hexadecimal string • 76 searching for • 76
HOME command • 80, 114, 131
I
IENMxxxx messages • 73
INPUT command • 36, 71, 115, 131
INSERT command • 113, 131 invoking an ACL/E program from an ACL/E program •
60, 115
K
KEY command • 33, 81, 113, 132
L
LEFT command • 79, 114, 132
LINECT variable • 41
LOG DD statement • 61
LOGOFF command • 59, 116, 133 loop in ACL/E program • 28, 62
M
message log • 61
MSG command • 61, 116, 133
N
NL command • 80, 114, 134
Notepad session • 23 notification from scheduled ACL/E programs • 98
NOTIFY command • 117, 134
O
OPENGATE • 73
OPTION command • 29, 32, 40, 61, 115, 116, 117,
135
OUTPUT command • 93, 117, 137
OUTPUTC command • 94, 117, 138
P
PA command • 114, 139
PANELS DD statement • 37 panels, displaying with ACL/E program • 117
PAUSE command • 72, 115, 139
PF command • 69, 114, 140 programs • 25, 26, 28, 31, 35, 39, 44, 51, 72, 73, 75,
76, 82, 107, 109, 110, 111, 112 comparing contents of two accumulators • 51 copying • 39, 44 data from an array to a data set member • 44 screen image into an array • 39 screen image to a data set • 39 cursor sensitive help • 107 determining if screen contains data • 76 displaying • 35, 112 custom screens • 35 system information • 35 user and terminal ID • 112 examining • 72, 73 last action entered by user • 73 user input • 72 inserting text • 82 monitoring storage statistics • 112 printing PDS members from ISPF • 110 processing PDS members • 109 reassigning PF keys • 111 repeating a string • 28 replying to hello • 26 saying hello • 25 searching for a character string • 75 signing off CATPX • 110 signing on to TSO • 31 submitting an action key • 111 suspending an ACL/E program • 72
R
redirecting idle ACL/E program • 62
RESET command • 113, 140
RESUME command • 140
RIGHT command • 79, 114, 141
S
SCAN command • 115, 141 screen • 41 size of • 41
SEARCH command • 32, 54, 78, 113, 142
SEARCHF command • 78, 113, 143
SEARCHN command • 72, 113, 144
SEND command • 72, 114, 145
SET command • 145 signing off CATPX • 59
SIGNOFF command • 116, 146
SRCHWAIT command • 71, 115, 147 startup ACL/E programs • 60, 70 statements • 17
STOP command • 24, 25, 115, 147 strings • 19
SUB command • 50, 115, 148
SUSPEND command • 98, 117, 148 suspending ACL/E program execution • 69, 72
T
TABB command • 46, 81, 114, 149
TABF command • 45, 81, 114, 150
TABL command • 114, 150
TERMSESS command • 58, 73, 115, 150
TPXDEMO session • 104
U
UDEFINE command • 41, 89, 116, 151
UDELETE command • 91, 116, 152 uncontrolled loops • 62
UP command • 79, 114, 152
V
variables • 41, 65, 67, 68, 77, 78, 79, 85, 95, 157, 161
Index 171
&A1-&A4 • 157
&AID • 157
&APPL • 65, 67, 157
&APPL_INF(applID) • 68
&APPLID • 157
&CSRCOL • 79, 157
&CSRROW • 79, 157
&CURSOR • 79, 157
&ERR_MSG • 157
&ERR_RC • 157
&IPADDR • 157
&IPPORT • 157
&IPVECT • 157
&LOC • 157
&LOCCOL • 78, 157
&LOCROW • 78, 157
&MSIZE_OF(string) • 161
&NETNAME • 157
&NPSWD • 157
&OPSWD • 157
&P1-&P8 • 157
&PRINTER • 157
&PSWD • 157
&SCREEN • 77, 157
&SCRNCOLS • 41, 77, 157
&SCRNROWS • 41, 77, 157
&SCRNSIZE • 77, 157
&SESS_INF(sessionID) • 68, 161
&SID • 65, 67, 157
&SIZE_OF(string) • 161
&TAID • 157
&TCSRCOL • 157
&TCSRROW • 95
&TCURSOR • 95, 157
&TYPE_OF(variable) • 161
&USERID • 157
&VTERM • 157
&ZAPPLID • 157
&ZCONN • 157
&ZDATE • 157
&ZEDATE • 157
&ZJDATE • 157
&ZLDATE • 157
&ZLEDATE • 157
&ZLJDATE • 157
&ZMODEL • 157
&ZSMFID • 157
&ZSYSID • 157
&ZTIME • 157
172 ACL/E Programming Guide
LINECT • 41 naming ACL/E variables • 85
TCSRROW • 157
VDEFINE command • 41, 89, 116, 153
VDELETE command • 91, 116, 154
W
WAIT command • 69, 115, 154
WINP command • 32, 70, 155 writing a message to the message log • 61
X
X suffix in SEARCH statement • 76
Unduh
Tautan publik diperbarui
Tautan publik ke obrolan Anda telah diperbarui. You may view and manage your chat links after registration here.
Tautan publik dokumen
Iklan