z/OS TSO/E CLISTs
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS TSO/E CLISTs
SA32-0978-00
Abstract for TSO/E CLISTs
z/OS Version 2 Release 1 summary of changes
Introduction
Features of the CLIST Language
Categories of CLISTs
CLISTs that perform routine tasks
CLISTs that are structured applications
CLISTs that manage applications written in other languages
Creating, editing, and executing CLISTs
CLIST data sets and libraries
Creating and editing CLIST data sets
CLIST data set attributes
Considerations for copying CLIST data sets
Executing CLISTs
Passing parameters to CLISTs
Allocating CLIST libraries for implicit execution
Specifying alternative CLIST libraries with the ALTLIB command
Using the ALTLIB command
Using ALTLIB with ISPF
Stacking ALTLIB requests
Examples of the ALTLIB command
Writing CLISTs - Syntax and conventions
Overview of CLIST statements
Syntax rules
Delimiters
Continuation symbols
Capitalization
Formatting
Length
Labels
Comments
Characters supported in CLISTs
TSO/E commands and JCL statements
TSO/E commands
JCL statements
Operators and expressions
Order of evaluations
Valid numeric ranges
The double-byte character set (DBCS)
DBCS delimiters
DBCS restrictions
Using symbolic variables
What is a symbolic variable?
Valid names of variables
Valid values of variables
Defining symbolic variables and assigning values to them
Using the SET statement
Using the READ statement
Using the PROC statement
Passing parameters to a PROC statement
Using PROC with positional parameters
Using PROC with keyword parameters
Keywords with values
Keywords without values
Using PROC with both positional and keyword parameters
Examples
More advanced uses of variables
Combining symbolic variables
Using a variable to preserve leading spaces in a CLIST
Increasing the amount of storage available for variables
Nesting symbolic variables
Combining nested variables with character strings
Substitution of nested variables
Combining variables containing DBCS data
Using keyword names
Using keyword names as variables or labels within a CLIST
Using control variables
Overview of using control variables
Getting the current date and time
&SYSDATE, &SYSSDATE, and &SYSJDATE
&SYS4DATE, &SYS4SDATE, and &SYS4JDATE
&SYSTIME and &SYSSTIME
Getting terminal characteristics
&SYSTERMID
&SYSLTERM and &SYSWTERM
Getting information about the user
&SYSUID
&SYSPREF
&SYSPROC
Getting information about the system
&SYSCLONE
&SYSCPU and &SYSSRV
&SYSDFP
&SYSHSM
&SYSISPF
&SYSJES
&SYSLRACF
&SYSAPPCLU
&SYSMVS
&SYSNAME
&SYSNODE
&SYSOPSYS
&SYSRACF
&SYSPLEX
&SYSSECLAB
&SYSSMS
&SYSSMFID
&SYSSYMDEF
&SYSTSOE
Getting information about the CLIST
&SYSENV
&SYSSCAN
&SYSICMD
&SYSPCMD
&SYSSCMD
Relationship between &SYSPCMD and &SYSSCMD
&SYSNEST
Setting options of the CLIST CONTROL statement
&SYSPROMPT
&SYSSYMLIST
&SYSCONLIST
&SYSLIST
&SYSASIS
&SYSMSG
&SYSFLUSH
Getting information about user input
&SYSDLM
&SYSDVAL
Trapping TSO/E command output
&SYSOUTTRAP
&SYSOUTLINE
Considerations for using &SYSOUTTRAP and &SYSOUTLINE
Getting return codes and reason codes
&LASTCC
&MAXCC
Getting results of the TSOEXEC command
Getting data set attributes
The LISTDSI statement
Using built-in functions
Determining the data type of an expression - &DATATYPE
Forcing arithmetic evaluations - &EVAL
Determining an expression's length in bytes - &LENGTH
Suppressing arithmetic evaluations
Including leading and trailing blanks and leading zeros
Determining an expression's length in characters - &SYSCLENGTH
Preserving double ampersands - &NRSTR
Double ampersands
One level of symbolic substitution
Records containing JCL statements
Temporary data set names
Symbolic parameters
Defining character data - &STR
Using &STR with &SYSDATE or &SYSSDATE
Using &STR with leading and trailing blanks
Using &STR with strings that match CLIST statement names
Using &STR when supplying input using SYSIN JCL statements
Defining a substring - &SUBSTR
Defining a substring - &SYSCSUBSTR
Converting character strings to uppercase characters - &SYSCAPS
Converting character strings to lowercase characters - &SYSLC
Determining data set availability - &SYSDSN
Locating one character string within another - &SYSINDEX
Using &SYSINDEX with DBCS strings
Limiting the level of symbolic substitution - &SYSNSUB
Converting DBCS data to EBCDIC - &SYSONEBYTE
Converting EBCDIC data to DBCS - &SYSTWOBYTE
Structuring CLISTs
Making selections
The IF-THEN-ELSE sequence
The standard format
The Null ELSE format
The Null THEN format
Nesting IF-THEN-ELSE sequences
The SELECT statement
Using SELECT without a test expression (simple SELECT)
Using SELECT with a test expression (compound SELECT)
Distinguishing WHEN clauses from WHEN commands
Distinguishing the SELECT statement from the RACF SELECT subcommand
Loops
The DO-WHILE-END sequence
The DO-UNTIL-END sequence
The Iterative DO sequence
Compound DO sequences
Nesting loops
Distinguishing END statements from END commands or subcommands
Using the CONTROL statement
Using the DATA-ENDDATA sequence
Subprocedures
Calling a subprocedure
Returning information from a subprocedure
Using the RETURN CODE statement
Using the SYSREF statement
Sharing variables among subprocedures
Using the NGLOBAL statement
Restricting variables to a subprocedure
Considerations for using other statements in subprocedures
Using ATTN and ERROR statements in subprocedures
Using CONTROL statements in subprocedures
Using GOTO statements in subprocedures
Nesting CLISTs
Protecting the input stack from errors or attention interrupts
Global variables
Exiting from a nested CLIST
Using the END command
Using the EXIT statement
GOTO statements
Communicating with the terminal user
Prompting the user for input
Prompting with the PROC statement
Prompting with the WRITE and WRITENR statements
Prompting with TSO/E commands
Coding responses to prompts - the DATA PROMPT-ENDDATA sequence
Writing messages to the terminal
Using the WRITE and WRITENR statements
Controlling the display of informational messages
Receiving responses from the terminal
Using the READ statement
Controlling uppercase and lowercase for READ statement input
Using the READDVAL statement
Passing control to the terminal
Returning control after a TERMIN or TERMING statement
Entering input after a TERMIN or TERMING statement
Using ISPF panels
ISPF restrictions
Sample CLIST with ISPF panels
Performing file I/O
Characters supported in I/O
Opening a file
Closing a file
Reading a record from a file
Writing a record to a file
Updating a file
End-of-File processing
Special considerations for performing I/O
Writing ATTN and ERROR routines
Writing attention routines
Canceling attention routines
Protecting the input stack from attention interrupts
Sample CLIST with an attention routine
Subprocedures and attention routines
CLIST attention facility
Writing error routines
Canceling error routines
Protecting the input stack from errors
Sample CLIST with an error routine
Subprocedures and error routines
Testing and debugging CLISTs
Using diagnostic options of the CONTROL statement
Messages in diagnostic output
How to make diagnostic output optional in a CLIST
Getting help for CLIST messages
Obtaining CLIST error codes
Sample CLISTs
Including TSO/E Commands - the LISTER CLIST
Simplifying routine tasks - the DELETEDS CLIST
Creating arithmetic expressions from user-supplied input - the CALC CLIST
Using front-end prompting - the CALCFTND CLIST
Initializing and invoking system services - the SCRIPTDS CLIST
Invoking CLISTs to perform subtasks - the SCRIPTN CLIST
Including JCL statements - the SUBMITDS CLIST
Analyzing input strings with &SUBSTR - the SUBMITFQ CLIST
Allowing foreground and background execution of programs - the RUNPRICE CLIST
Including options - the TESTDYN CLIST
Simplifying system-related tasks - the COMPRESS CLIST
Simplifying interfaces to applications - the CASH CLIST
Using &SYSDVAL when performing I/O - the PHONE CLIST
Allocating data sets to SYSPROC - the SPROC CLIST
Writing full-screen applications using ISPF dialogs - the PROFILE CLIST
Allocating a data set with LISTDSI information - the EXPAND CLIST
Reference
How to read the CLIST statement syntax
ATTN statement
CLOSFILE statement
CONTROL statement
DATA-ENDDATA sequence
DATA PROMPT-ENDDATA sequence
DO statement
END statement
ERROR statement
EXIT statement
GETFILE statement
GLOBAL statement
GOTO statement
IF-THEN-ELSE sequence
LISTDSI statement
CLIST variables set by LISTDSI
Return codes
Reason codes
NGLOBAL statement
OPENFILE statement
PROC statement
PUTFILE statement
READ statement
READDVAL statement
RETURN statement
SELECT statement
Simple SELECT
Compound SELECT
SET statement
SYSCALL statement
SYSREF statement
TERMIN and TERMING statement
WRITE and WRITENR statements
END command
EXEC command
Copyright IBM Corporation 1990, 2014