+---------------------------------------+ | | | | | Document #6211003 | | | | TSO Command Language Reference Manual | | | | Version of 08/03/83 | | | | | | 244 Pages | | | +---------------------------------------+ UIC TSO COMMAND LANGUAGE REFERENCE MANUAL 08/03/83 The following is a list of available TSO Commands available at UIC. A table of these commands is listed immediately following, under the page heading COMMAND, which gives a quick description of each available command. Following this COMMAND list, is an alphabetical listing of the most widely used standard commands, and the local UIC commands -- giving complete descriptiontopof the function, syntax, operand entries, and sub-commands (if any). At the top right of each page is the name of the first command being described on that page. At the bottom right, is the name of the last command listed on the page. Note Added June, 1986 This is one of the two basic Computer Center Documents on TSO: TSO (Time Sharing Option) Guide, a user's manual, and TSO Command Language Reference, which is a collection of the TSO help files, as they were in 1983. If you must use TSO, these manuals will help you learn, but both of these documents are very old ( TSO (Time Sharing Option) Guide is dated 1979), both contain information about commands and packages that are no longer available, and they are no longer being updated. Page 3 COMMAND COMMAND NAME - COMMAND THE FOLLOWING IS A LIST OF THE TSO COMMANDS AVAILABLE AT UICC. BECAUSE OF SPACE CONSIDERATIONS, WE HAVE ELIMINATED COMMANDS WHICH ARE INFREQUENTLY USED. COMMANDS WHICH HAVE BEEN INCLUDED IN THE PRESENT MANUAL ARE MARKED WITH AN ASTERISK (*) AT THE LEFT OF THE COMMAND NAME. TO OBTAIN HELP ON ANY COMMAND LISTED, THE USER MAY USE THE TSO HELP COMMAND, AS INDICATED HEREIN. SESSION CONTROL COMMANDS: ACF INVOKE THE ACCESS CONTROL SYSTEM PROCESSOR. ACCT INVOKE THE COMPUTER CENTER ACCOUNT RECORD EDITOR. * ALTPSWD USED TO CHANGE THE PASSWORD OF YOUR ACCOUNT. ASK ORACLE OF TSO: SEES ALL KNOWS ALL. * DOCUM OBTAIN INFORMATION ABOUT SUBROUTINES & PACKAGES. * DT DISPLAYS THE TIME OF DAY (CENTRAL TIME),AND THE DATE. * EXEC INVOKE COMMAND PROCEDURE. * HELP INVOKE HELP PROCESSOR. FOR HELP ON SYSTEM ABEND CODES, TYPE "HELP ABEND". FOR HELP ON ALLOCATION ERROR CODES, TYPE "HELP ERROR". * JCL DYNAMICALLY CREATES JCL CARDS FOR COMMON JOBS. * LOCATE SEARCH SYSTEM CATALOG FOR DATA SET NAME. * LOGOFF END TERMINAL SESSION. * LOGON START TERMINAL SESSION. * MODESET SETS USER MODE PROFILE PREFIX: PROJECT,MAST,SUB * PROCHELP LIST SYSTEM JCL PROCEDURE. RETRY EDIT AND RESUBMIT PREVIOUSLY ENTERED COMMANDS. * PROFILE DEFINE USER CHARACTERISTICS. * SEND SEND MESSAGE TO OPERATOR/USER. * SETTERM SET TERMINAL AND PROFILE CHARACTERISTICS. * SPACE DISPLAY DISK SPACE USAGE. Page 4 COMMAND * FORT INVOKE FORTRAN PROMPTER AND FORTRAN IV G1 COMPILER. * LISP INVOKE THE LISP PROCESSOR. * MINITAB2 INVOKE VERSION II OF THE MINITAB STATISTICAL PROGRAM * PLC INVOKE THE PLC "STUDENT PL/I" COMPILERCOMPILER. * PLI INVOKE THE PL/I OPTIMIZING COMPILER. PLIFC INVOKE THE PL1-F COMPILER. * SAS76 INVOKE 1976 VERSION OF THE STATISTICAL ANALYSIS SYSTEM * SCSS INVOKE SPSS CONVERSTIONAL STATISTICAL SYSTEM * SPEAKEZE INVOKE THE SPEAKEASY INTERACTIVE PROCESSOR. * SPITBOL INVOKE THE SPITBOL (SNOBOL) COMPILER. * TSECAP INVOKE THE ECAP PROCESSOR. * WATFIV INVOKE THE WATFIV COMPILER. DATA MANAGEMENT COMMANDS: * ADDPROC IS USED TO CONCATENATE A USER'S LIBRARY OF TSO COMMAND PROCEDURES WITH THE SYSTEM LIBRARY. * ALLOCATE ALLOCATE A DATA SET. * ATTRIB ALLOW DCB PARAMETERS TO BE DYNAMICALLY INTRODUCED AND NAMED FOR USE WITH A SUBSEQUENT ALLOCATE COMMAND. * CATLG CATALOGS THE OPERAND DATA SET. * COMPRESS USED TO ELIMINATE BLANK TRACKS ON DISK. CONCAT CONCANTENATES ALL SPECIFIED DATA SETS UNDER ONE. CONPLIF CREATES DATA SET OF FIXED BLOCKS OF 80 FROM * COPY COPY A DATA SET. DECON DECONCANTENATES A PREVIOUSLY CONCANTENATED GROUP. * DELETE DELETE A DATA SET. DELSEQ# DELETE SEQUENCE NUMBERS FROM DATA SET. DSNAME DISPLAY IDS OF JOBS WHICH HAVE A DATA SET ALLOCATED. * EDIT CREATE, EDIT, AND/OR EXECUTE A DATA SET. EDITOUT LISTS OR FINDS REQUESTED DATA FROM DATA SET RETRIEVED BY FETCH COMMAND. ENCRIPT ENCODES/DECODES OPERAND DATA SET. * FORMAT INVOKE FORMAT TEXT FORMATTING PROGRAM. * FREE RELEASE A DATA SET. * FREEALL RELEASE ALL ALLOCATED DATA SETS AND ATTRIBUTE LISTS. * LIST DISPLAY A DATA SET. * LISTALC DISPLAY ACTIVE DATA SETS. * LISTBC DISPLAY MESSAGES FROM OPERATOR/USER. LISTCAT DISPLAY USER CATALOGUED DATA SETS. * LISTDS DISPLAY DATA SET ATTRIBUTES. * MEMBERS DISPLAY FORMATTED LIST OF PARTITIONED DATASETS MEMBERS * MERGE COMBINE DATA SETS. * PRESS CONVERT DATA SET FROM TSO FORMAT TO WYLBUR FORMAT. * QED FAST VERSION OF EDIT FOR SMALL DATA SETS. * RELEASE RELEASES UNUSED SPACE FROM A DATA SET. * RENAME RENAME A DATA SET. * RULER DISPLAY COLUMN POSITIONS AT TERMINAL. COMMAND Page 5 COMMAND * SCRIPT INVOKE THE WATERLOO SCRIPT TEXT FORMATTING PROGRAM. * TFORM INVOKE THE TFORM TEXT FORMATTING PROGRAM. * UNPRESS CONVERT DATA SET FROM WYLBUR FORMAT TO TSO FORMAT. INTERACTIVE PROGRAM CONTROL COMMANDS: * CALL LOAD AND EXECUTE THE SPECIFIED LOAD MODULE. * LIBCALL EXECUTE THE SPECIFIED SYSTEM PROGRAM. * LINK INVOKE LINK PROMPTER AND LINKAGE EDITOR. * LOADGO LOAD AND EXECUTE PROGRAM. * RUN COMPILE, LOAD, AND EXECUTE PROGRAM. * TEST TEST USER PROGRAM. BATCH JOB PROGRAM CONTROL COMMANDS: * DUPLICAT DUPLICATE DATA SET ON THE LINE PRINTER AND/OR CARD PUNCH. * FETCH DIRECT OUTPUT MEDIUM FOR BACKGROUND JOB. * LABELS PRINT A SPECIALLY FORMATTED TEXT DATA SET AS MAIL LABELS * PRINTOFF CREATE SYSOUT COPY OF SEQUENTIAL OR PARTITIONED DATA SET * PURGE CANCEL BACKGROUND JOB. * ROUTE REQUESTS HASP TO ROUTE A JOB CURRENTLY IN THE FETCH QUEUE. * SCHEDULE SUBMIT BACKGROUND JOB TO BATCH. * SHOW LIST STATUS OF BACKGROUND JOB. DATA MIGRATION/RETRIEVAL COMMANDS: * $AI DISPLAY CONTENTS OF THE ARCHIVE CATALOG (ARCHIVE INQUIRY) * $BI DISPLAY CONTENTS OF BACK-UP CATALOG (BACK-UP INQUIRY) * $DA REMOVE DATA SET FROM ARCHIVE CATALOG * $SM SPACE MANAGEMENT FOR SEQUENTIAL/PARTITIONED DATA SETS $SP DISPLAY SPACE INFORMATION FOR DATASETS $SQ RELEASE (SQUEEZE OUT) UNUSED SPACE * $US DISPLAY INFORMATION ON LAST USAGE OF DATA SET * ARCHIVE FLAG DATA SETS ON CATALOG FOR MIGRATION TO ARCHIVE TAPES * RECOVER RETRIEVE DATA SETS FROM BACK-UP TAPES TO ONLINE STORAGE. * RELOAD RETRIEVE DATA SETS FROM ARCHIVE TAPES TO ON-LINE STORAGE. ACCESS METHOD SERVICE COMMANDS: ALTER ALTER ATTRIBUTES IN CATALOG ENTRIES. BLDINDEX BUILD ALTERNATE INDEX FOR VSAM CLUSTER CNVTCAT ENTRIES IN AN OS CATALOG ARE CONVERTED TO ENTRIES IN COMMAND Page 6 COMMAND AN EXISTING VS2 MASTER OR USER CATALOG. DEFINE DEFINE USER CATALOGS,DATA SPACES, CLUSTERS, PAGE SPACES, NONVSAM DATASETS, ALIAS NAMES, AND GENERATION DATA GROUPS. EXPORT MOVE A CLUSTER OR USER CATALOG ENTRY FROM THE SYSTEM IN WHICH THE COMMAND IS EXECUTED. IMPORT MOVE A CLUSTER OR USER CATALOG ENTRY INTO THE SYSTEM IN WHICH THE COMMAND IS EXECUTED. LISTCRA LIST THE CONTENTS OF A CATALOG RECOVERY AREA (CRA). PRINT LIST ALL OR PART OF AN INDEXED SEQUENTIAL, SEQUENTIAL, OR VSAM DATASET. REPRO COPY VSAM CLUSTERS, CATALOGS, AND NONVSAM DATASETS. RESETCAT IS USED TO RECOVER CATALOG ENTRIES. VERIFY VERIFY END OF FILE. COMMAND NAME - $AI FUNCTION THE ARCHIVE INQUIRY COMMAND LISTS COMPLETELY OR PARTIALLY THE NAMES OF A USER'S ARCHIVED DATA SETS. SYNTAX $AI U('INDEX') CYCLE('INTEGER') TAPE('VOLSER') ALL ACTIVE/INACTIVE VOL NONO PERM REQUIRED - NONE DEFAULTS - INDEX = USERID WHICH ISSUED COMMAND. IF NO OPERANDS ARE ENTERED, THE LISTING PRODUCED WILL INCLUDE THE NAMES OF ALL ARCHIVED DATA SETS UNDER THE USERID WHICH DO NOT CURRENTLY RESIDE ON DISK. SUCH DATA SETS HAVE EITHER BEEN RESTORED AND SUBSEQUENTLY DELETED OR HAVE NEVER BEEN RESTORED SINCE ARCHIVAL. IN EITHER CASE THEIR CONCEPTUAL LOCATION IS 'ARCHIVES'. NOTE - TO RETRIEVE DATA SETS FROM THE ARCHIVE TAPES, USE THE RELOAD COMMAND. NOTE - TO LIST DATA SETS FROM THE SYSTEM BACK-UP CATALOG, USE THE $BI COMMAND. OPERANDS $AI Page 7 $AI U('INDEX') - THE NAMES OF ARCHIVED DATA SETS WHOSE NAMES BEGIN WITH THE CHARACTER STRING 'INDEX' ARE DISPLAYED. THE STRING SHOULD NOT BE ENCLOSED IN APOSTROPHES. CYCLE('INTEGER') - THE LISTING IS RESTRICTED TO DATA SETS ARCHIVED WITHIN THE LAST 'INTEGER' DAYS. - 'INTEGER' - A THREE DIGIT VALUE WHICH RESTRICTS LISTING TO DATA SETS ARCHIVED WITHIN THE SPECIFIED NUMBER OF DAYS. TAPE('VOLSER') - THE LISTING IS RESTRICTED TO DATA SETS ON TAPE REEL DESIGNATED BY 'VOLSER'. - 'VOLSER' - A SIX CHARACTER VALUE WHICH RESTRICTS THE LISTING TO DATA SETS ON THE TAPE VOLUME SPECIFIED. ALL - THE LISTING IS EXPANDED TO INCLUDED ARCHIVED DATA SETS WHICH HAVE BEEN SUBSEQUENTLY RESTORED TO DISK. ACTIVE - THE LISTING IS RESTRICTED TO DATA SETS WHOSE RETENTION PERIOD ON TAPE HAS NOT EXPIRED. INACTIVE - THE LISTING IS RESTRICTED TO DATA SETS WHOSE RETENTION PERIOD ON TAPE HAS EXPIRED. VOL - THE LISTING WILL ALSO PROVIDE THE PRECISE TAPE VOLUME SERIAL NUMBER AND FILE SEQUENCE OF EACH ARCHIVED DATA SET NAME DISPLAYED. NONO - THE HEADING INFORMATION WHICH NORMALLY PRECEDES THE LIST WILL NOT BE DISPLAYED. PERM - THE LISTING IS RESTRICTED TO DATA SETS WHICH RESIDE ON PERMANENT ARCHIVE TAPES. $BI Page 8 $BI COMMAND NAME - $BI FUNCTION THE BACKUP INQUIRY COMMAND LISTS COMPLETELY OR PARTIALLY THE NAMES OF A USER'S BACKED UP DATA SETS. SYNTAX $BI U('INDEX') CYCLE('INTEGER') TAPE('VOLSER') ALL ACTIVE/INACTIVE VOL NONO REQUIRED - NONE DEFAULTS - INDEX = USERID WHICH ISSUED COMMAND. IF NO OPERANDS ARE ENTERED, THE LISTING PRODUCED WILL INCLUDE THE NAMES OF ALL BACKED UP DATA SETS UNDER THE USERID WHICH DO NOT CURRENTLY RESIDE ON DISK NOTE - TO RETRIEVE DATA SETS FROM THE SYSTEM BACK-UP TAPES, USE THE RECOVER COMMAND. NOTE - TO LIST DATA SETS FROM THE ARCHIVE CATALOG, INSTEAD OF THE SYSTEM BACK-UP CATALOG, USE THE $AI COMMAND. OPERANDS U('INDEX') - THE NAMES OF BACKED UP DATA SETS WHOSE NAMES BEGIN WITH THE CHARACTER STRING 'INDEX' ARE DISPLAYED. THE CHARACTER STRING SHOULD NOT BE ENCLOSED IN APOSTROPHES. CYCLE('INTEGER') - THE LISTING IS RESTRICTED TO DATA SETS BACKED UP WITHIN THE LAST 'INTEGER' DAYS. - 'INTEGER' - A THREE DIGIT VALUE WHICH RESTRICTS LISTING TO DATA SETS BACKED UP WITHIN THE SPECIFIED NUMBER OF DAYS. TAPE('VOLSER') - THE LISTING IS RESTRICTED TO DATA SETS ON TAPE REEL DESIGNATED BY 'VOLSER'. - 'VOLSER' - A SIX CHARACTER VALUE WHICH RESTRICTS THE LISTING TO DATA SETS ON THE TAPE VOLUME SPECIFIED. $BI Page 9 $BI ALL - THE LISTING IS EXPANDED TO INCLUDED BACKED UP DATA SETS WHICH HAVE BEEN SUBSEQUENTLY RESTORED TO DISK. ACTIVE - THE LISTING IS RESTRICTED TO DATA SETS WHOSE RETENTION PERIOD ON TAPE HAS NOT EXPIRED. INACTIVE - THE LISTING IS RESTRICTED TO DATA SETS WHOSE RETENTION PERIOD ON TAPE HAS EXPIRED. VOL - THE LISTING WILL ALSO PROVIDE THE PRECISE TAPE VOLUME SERIAL NUMBER AND FILE SEQUENCE OF EACH BACKED UP DATA SET NAME DISPLAYED. NONO - THE HEADING INFORMATION WHICH NORMALLY PRECEDES THE LIST WILL NOT BE DISPLAYED. COMMAND NAME - $DA FUNCTION THE DELETE FROM ARCHIVES COMMAND DEACTIVATES ENTRIES IN THE ARCHIVE CATALOG. SYNTAX $DA 'DSLIST' - 'INTEGER' REQUIRED - 'DSLIST' DEFAULTS - NONE. IN ABSENCE OF 'INTEGER', $DA WILL DELETE FROM ARCHIVES THE MOST RECENTLY ARCHIVED VERSION OF A DATA SET. OPERANDS 'DSLIST' - LIST OF INPUT DATA SET NAMES. $DA Page 10 $DA INTEGER - DESIGNATES THAT A BACK LEVEL OF THE NAMED DATA SET IS TO BE DELETED FROM ARCHIVES. (IMPLIES THERE ARE MULTIPLE DATA SETS IN THE ARCHIVES WITH THE SAME DATA SET NAME.) 'INTEGER' - 1 OR 2 INTEGERS (1-99) WHICH DESIGNATES WHICH OF THE BACK VERSIONS IS DESIRED. (ANALOGOUS IN CONCEPT TO GENERATION DATA SETS). EXAMPLE: DATASETX.DATA(-2) REFERS TO A VERSION OF DATASETX.DATA TWO OLDER THAN THE MOST RECENTLY ARCHIVED VERSION OF THE DATA SET. COMMAND NAME - $SM FUNCTION - GIVE SPACE ALLOCATION INFORMATION FOR DATASET(S) RELEASE UNUSED SPACE OF DATASET(S) - EITHER PARTIONED - OR SEQUENTIAL COMPRESS PARTIONED DATASET(S) LIST OUTPUT OF IEBCOPY FROM BACKUP AND/OR COMPRESS BACK-UP PARTITIONED DATASET(S) RESET SEQUENTIAL DATASET(S) - THAT IS, COMPLETELY EMPTY - THEM. SYNTAX - $SM DSNAME(DATA-SET-NAME)/INDEX(INDEX) BACKUP/NOBACKUP COMPRESS/NOCOMPRESS RLSE/NORLSE SAVE(AMOUNT) SYSOUT/NOSYSOUT LIST/NOLIST NODIR KEEP/NOKEEP SPACE(PRI,SEC) DIRECTORY(BLOCKS) TRACKS/CYLINDERS UNIT(UNIT) SERIAL(VOL-SER) RESET/NORESET QUALIFY(QUALIFIER)/NEWNAME(DSNAME) COMMAND DEFAULTS - I(INDEX) INDEX = USERID OF ISSUER BACKUP NOCOMPRESS NORLSE NOSYSOUT $SM Page 11 $SM LIST NOKEEP SPACE(INPUT DATASET SIZE) DIRECTORY(INPUT DATASET NUMBER) TRACKS UNIT(SYSDA) NORESET QUALIFY(BKUP) OPERANDS - DSNAME(DATASET NAME/DSN-LIST) ALIAS DATASET - SPECIFIES A DSNAME FOR WHICH YOU DESIRE TO HAVE VOLUME INFORMATION LISTED. INDEX(INDEX-LEVEL) ALIAS - LEVEL, USER - SPECIFIES AN INDEX LEVEL IN THE CATALOG ON WHICH YOU WANT THE COMMAND TO OPERATE. BACKUP/NOBACKUP - SPECIFIES WHETHER OR NOT A BACKUP COPY OF A PARTITIONED DATASET IS TO BE TAKEN BEFORE A COMPRESS IS DONE. IF COMPRESS NOT SPECIFIED AND KEEP SPECIFIED, THEN JUST A BACKUP COPY IS MADE. (NOBACKUP REDUCES COMPRESS BY APPR. 50%) COMPRESS/NOCOMPRESS - SPECIFIES WHETHER OR NOT A COMPRESS IS TO BE DONE ON PARTITIONED DATASET(S). RLSE/NORLSE - SPECIFIES WHETHER OR NOT TO RELEASE UNUSED SPACE IN DATASET(S). SAVE(AMOUNT) - USED IN CONJUNCTION WITH RLSE, SPECIFIES THE AMOUNT OF UNUSED SPACE IN A DATASET NOT TO RELEASED. SYSOUT/NOSYSOUT - SPECIFIES WHETHER OR NOT THE OUTPUT FROM IEBCOPY IS TO BE DIRECTED TO THE TERMINAL. LIST/NOLIST - SPECIFIES WHETHER OR NOT THE DATASET SPACE INFORMATION IS TO DISPLAYED AT THE TERMINAL. $SM Page 12 $SM NODIR - SPECIFIES THAT DIRECTORY INFORMATION IS NOT TO BE CALCULATED. (WILL SAVE TIME) KEEP/NOKEEP - SPECIFIES WHETHER OR NOT THE BACKED UP COPY OF A PDS IS TO BE RETAINED. SPACE(PRIMARY,SECONDARY) - SPECIFIES THE SPACE ALLOCATION DATA TO BE USED FOR THE BACKUP COPY OF A PDS BEFORE COMPRESSING. NOTE: DEFAULT IS THE CURRENT SIZE OF THE INPUT PDS DIRECTORY(BLOCKS) - SPECIFIES THE NUMBER OF DIRECTORY TO BE ALLOCATED FOR THE BACKUP COPY OF A PDS BEFORE COMPRESSING. NOTE: DEFAULT IS THE CURRENT NUMBER OF THE INPUT PDS TRACKS/CYLINDERS - SPECIFIES WHETHER TRACKS OR CYLINDERS ARE THE UNITS OF ALLOCATION OF THE BACKUP COPY UNIT(UNIT) - SPECIFIES THE DEVICE TYPE FOR THE BACKUP COPY OF A PDS BEFORE COMPRESSING. SERIAL(VOL-SER) ALIAS VOLUME(VOL-SER) - SPECIFIES THE VOLUME ID THAT THE BACKUP COPY IS TO RESIDE. RESET/NORESET - SPECIFIES WHETHER OR NOT A SEQUENTIAL DATASET IS TO CLEARED( END-OF-FILE AT START OF DATASET). QUALIFY(QUALIFIER)/NEWNAME(DSNAME) - SPECIFIES WHETHER THE BACKUP COPY NAME IS GOING TO BE DERIVED FROM THE INPUT PDS NAME PLUS AN ADDITIONAL QUALIFER OR IS HAVE A TOTALLY NEW NAME. $US Page 13 $US COMMAND NAME - $US FUNCTION THE USAGE COMMAND ALLOWS THE USER TO DISPLAY CURRENT USAGE DATA FOR ANY ONLINE, CATALOGUED DASD DATA SET. USAGE DATA CONSISTS OF DATA SET USE COUNT, DATE OF LAST USE, AND DATE, TIME OF DAY, AND JOBNAME/USERID AT LAST DATA SET MODIFICATION. SYNTAX $US 'DSLIST'/U(USERID) REQUIRED - NONE DEFAULT- USERID OF ISSUER OR JOBNAME MINUS ONE CHARACTER. OPERANDS 'DSLIST' - LIST OF INPUT DATA SET NAMES. U(USERID) - USERID FOR WHICH USAGE INFORMATION FOR ALL DATASETS UNDER THAT QUALIFIER IS DESIRED. COMMAND NAME - ABEND FUNCTION - THIS IS NOT A COMMAND, BUT A LIST (AND EXPLANATION) OF SOME OF THE MORE COMMON ABEND CODES. IF THIS LIST DOES NOT INCLUDE YOUR ABEND CODE, YOU WILL HAVE TO LOOK IT UP IN THE 'MESSAGES AND CODES' MANUAL. SYNTAX - HELP ABEND OPERAND(SXXX) - REQUIRED - ABEND SYSTEM ABEND CODES ARE ALWAYS 3 HEXADECIMAL DIGITS, AND LEADING ZEROS SHOULD BE RETAINED. NOTE: MOST ABENDS HAVE MULTIPLE MESSAGES. THE USER WILL BE INSTRUCTED TO ENTER MORE INFORAMTION FOR FURTHER HELP. OPERANDS ABEND Page 14 ABEND OPERAND(SXXX) - XXX SPECIFIES THE SYSTEM ABEND CODE FOR EXAMPLE: H ABEND O(S0C1) INQUIRES ABOUT SYSTEM 0C1 ABENDS COMMAND NAME - ACF Function - The ACF command invokes the Access Control Facility compiler. See the ACF Users Guide for command and language syntax. Syntax - ACF'FUNCTION' 'FUNCTION-DEPENDENT-OPERANDS' Where 'FUNCTION' is one of: Allow, Compile, Delete, List ACFList Prefix('prefix-list') Output('data-set name') Sysprint('sysout-class') ACFCompile * / 'data-set name' ACFDelete Prefix('prefix') ACFAllow Users('userid-list') Students / Students('call-number') Read Write Scratch (alias: Alloc, Rename) Datasets('data-set mask list') (alias: Dsnames()) Prefix('prefix') Update (alias: Add) / Replace To (just to make sentence structure syntactically more And compatible with spoken English) Required - for function 'Allow' - 'User' or 'Students' Defaults - Function defaults to 'List' 'Prefix' defaults to current session prefix (as set by LOGON, or PROFILE and MODESET commands) 'sysout-class' defaults to 'A'. for function 'Allow', Replace/Update defaults to Update. Note - To grant total access to another account using ACF Allow, specify all of Read, Write, and Scratch. Alias- none ACF Page 15 ACF Operands - PREFIX- the data set name prefix to be assumed for any data set name mentioned in an 'ACF Allow' command, or the prefix/key to be listed or deleted by 'ACF List' or 'ACF Delete'. OUTPUT- specification of a data set to be created and filed with listed ACF rules. an unquoted and nonexistant data set name will have .ACFLIST added as a qualifier. SYSPRINT - specifies that the listing of 'ACF List' should be routed to sysout class 'sysout-class' for immediate processing. 'DATA-SET-NAME' - the name of a data set which contains ACF rules to be compiled. this data set -must- be in the format produced for a .TEXT qualified data set, i.e. LRECL(255) RECFM(VB) BLKSIZE(3665). Default qualifier is .TEXT * - specifies that ACF rules for compilation will be entered interactively from the terminal. USERS - a list of userids to be allowed priveleges by this ACF command. A userid may be a Unique ID, a UICC ID number (which is assumed to be a student account number), or a 16 character Computer Center account number, STUDENTS - specifying this keyword allows all students access as specified by the other operands on the ACF Allow command line. 'call-number', if specified, limits privileges to those students who appear on the course roster. READ - allows read access WRITE - allows write access (access for output) SCRATCH- allows scratch, rename, and expansion of data set into extents. ACF Page 16 ACF DATASETS - specifies data set names or ACF data set masks to be included in any rules generated by ACF Allow. UPDATE - specifies that any generated rules be added to any existing ones. REPLACE- specifies that any generated rules replace all existing rules, if any. COMMAND NAME - ADDPROC FUNCTION - THE ADDPROC COMMAND IS USED TO CONCATENATE A USER LIBRARY OF TSO PROCEDURES TO THE SYSTEM LIBRARY. SYNTAX - ADDPROC 'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE ALIASES- NONE NOTE - TO DECONCATENATE THE USER LIBRARY, ENTER THE COMMAND: DECON SYSPROC OPERANDS - 'DSNAME' - THE NAME OF THE PARTITIONED CLIST DATA SET TO BE USED AS THE USER LIBRARY OF COMMANDS. COMMAND NAME - ALLOCATE FUNCTION - THE ALLOCATE COMMAND DYNAMICALLY DEFINES AND ALLOCATES A DATA SET WITH OR WITHOUT AN ATTRIBUTE LIST OF DCB PARAMETERS, OR CONCATENATES A LIST OF DATA SETS. ALLOCATE Page 17 ALLOCATE SYNTAX- ALLOCATE DATASET('DSNAME'/'LIST OF DSNAMES'/*) OR DUMMY FILE('DDNAME') ALTFILE('DDNAME') DEST('STATIONID') NEW/OLD/MOD/SHR/SYSOUT('CLASS') VOLUME('SERIAL'/SERIAL LIST)/MSVGP('IDENTIFIER') SPACE('QUANTITY','INCREMENT') DIR('INTEGER') BLOCK('VALUE')/AVBLOCK('VALUE')/TRACKS/CYLINDERS USING('ATTR-LIST-NAME') HOLD/NOHOLD UNIT('UNIT-TYPE') UCOUNT('COUNT')/PARALLEL LABEL('LABEL-TYPE') POSITION('SEQUENCE-NUMBER') MAXVOL('VOL-COUNT') PRIVATE RELEASE VSEQ('VOL-SEQ-NUMBER') ROUND REUSE KEEP/DELETE/CATALOG/UNCATALOG REQUIRED - NONE DEFAULT- NONE ALIAS- ALLOC NOTE - DATA SETS ALLOCATED REMAIN ALLOCATED UNTIL LOGOFF OR FREED BY FREE COMMAND. NO PERMANENT CONNECTION EXISTS BETWEEN THE ATTRIBUTE LIST AND DATA SET. - THE OPERAND 'DATASET' MAY ALSO BE SPECIFIED AS 'DSNAME'. THE OPERAND 'FILE' MAY ALSO BE SPECIFIED AS 'DDNAME'. THE OPERAND 'BLOCK' MAY ALSO BE SPECIFIED AS 'BLKSIZE'. OPERANDS - DATASET('DSNAME(S)'/*) OR DSNAME('DSNAME(S)'/*) - DSNAME IS NAME OF DATA SET TO BE ALLOCATED. LIST OF DSNAMES SPECIFIES THE DATA SETS ARE TO BE CONCATENATED. * INDICATES TERMINAL TO BE ALLOCATED DSNAME('DSNAME(S)'/*) OR DATASET('DSNAME(S)'/*) - DSNAME IS THE NAME OF DASE TO BE ALLOCATED. LIST OF DANAMES SPECIFIES THE DATA SETS ARE TO BE CONCATENATED. * INDICATES TERMINAL TO BE ALLOCATED. DUMMY - DUMMY DATA SET TO BE ALLOCATED FILE('DDNAME') OR DDNAME('DDNAME') - DDNAME TO BE ASSOCIATED WITH DATA SET ALLOCATE Page 18 ALLOCATE DDNAME('DDNAME') OR FILE('DDNAME') - DDNAME TO BE ASSOCIATED WITH DATA SET ALTFILE('DDNAME) - DDNAME OF SUBSYSTEM DATA SET TO BE ALLOCATED. DEST('STATIONID') - SPECIFIES A REMOTE WORK STATION TO WHICH SYSOUT DATA SETS WILL BE DIRECTED UPON UNALLOCATION. THE STATIONID IS THE ONE TO EIGHT CHARACTER NAME OF THE REMOTE WORK STATION RECEIVING THE SYSOUT DATA SET. OLD - DATA SET EXISTS AND EXCLUSIVE CONTROL IS REQUIRED SHR - DATA SET EXISTS BUT EXCLUSIVE CONTROL IS NOT REQUIRED MOD - ADDITIONS ARE TO BE MADE TO DATA SET NEW - DATA SET IS TO BE CREATED SYSOUT('CLASS') - DATA SET IS TO BE SYSTEM OUTPUT DATA SET VOLUME('SERIAL(S)') - VOLUME(S) ON WHICH DATA SET RESIDES OR IS TO RESIDE. MSVGP('IDENTIFIER') - IDENTIFIER OF THE MASS STORAGE GROUP ON WHICH THE DATA SET RESIDES. BLOCK('VALUE') OR BLKSIZE('VALUE') - BLOCK SIZE AND AVERAGE RECORD LENGTH AVBLOCK('VALUE') - AVERAGE RECORD LENGTH TRACKS - SPACE IS TO BE ALLOCATED BY TRACKS CYLINDERS - SPACE IS TO BE ALLOCATED BY CYLINDERS ALLOCATE Page 19 ALLOCATE SPACE('QUANTITY','INCREMENT') - THE NUMBER OF UNITS OF SPACE AND INCREMENT DIR('INTEGER') - INTEGER IS NUMBER OF DIRECTORY BLOCKS REQUIRED USING('ATTR-LIST-NAME') - ATTR-LIST-NAME IS NAME OF ATTRIBUTE LIST OF DCB PARAMETERS TO BE MERGED WITH A DATA SET AT DYNAMIC ALLOCATION TIME. HOLD - DATA SET IS TO BE PLACED ON A HOLD QUEUE UPON UNALLOCATION. NOHOLD - DATA SET IS NOT TO BE PLACED ON A HOLD QUEUE UPON UNALLOCATION. UNIT('UNIT-TYPE') - DEVICE TYPE TO WHICH A FILE OR DATA SET IS TO BE ALLOCATED. UCOUNT('COUNT') - MAXIMUM NUMBER OF DEVICES TO WHICH A FILE OR DATA SET MAY BE ALLOCATED. PARALLEL - ONE DEVICE MOUNTED FOR EACH VOLUME SPECIFIED ON THE VOLUME PARAMETER LABEL('LABEL-TYPE') - LABEL PROCESSING TO BE DONE FOR TAPE VOLUMES. POSITION('SEQUENCE-NUMBER') - RELATIVE POSITION OF THE DATA SET ON A MULTI-DATA SET TAPE. MAXVOL('VOL-COUNT') - MAXIMUM NUMBER OF VOLUMES A DATA SET MAY USE PRIVATE - A VOLUME WHICH IS NOT PERMANENTLY RESIDENT OR RESERVED IS TO BE ASSIGNED THE PRIVATE VOLUME USE ATTRIBUTE. RELEASE - UNUSED SPACE IS TO BE DELETED WHEN THE DATA SET IS CLOSED. ALLOCATE Page 20 ALLOCATE VSEQ('VOL-SEQ-NUM') - WHICH VOLUME OF A MULTI-VOLUME DATA SET TO BEGIN PROCESSING WITH. ROUND - ALLOCATED SPACE SHOULD BE EQUAL TO ONE OR MORE CYLINDERS. REUSE - FILE BEING ALLOCATED IS TO BE FREED AND RE-ALLOCATED IF CURRENTLY IN USE. KEEP - DATA SET IS TO BE KEPT WHEN FREED. DELETE - DATA SET IS TO BE DELETED WHEN FREED. CATALOG - DATA SET IS TO BE CATALOGED. UNCATALOG - DATA SET IS TO BE UNCATALOGED. COMMAND NAME - ALTER FUNCTION - THE ALTER COMMAND IS USED TO ALTER ATTRIBUTES IN CATALOG ENTRIES. SYNTAX - ALTER 'ENTRYNAME/PASSWORD' NEWNAME('NEWNAME') NULLIFY(MASTERPW CONTROLPW UPDATEPW READPW OWNER AUTHORIZATION(MODULE|STRING) RETENTION CODE EXCEPTIONEXIT ) MASTERPW('PASSWORD') CONTROLPW('PASSWORD') UPDATEPW('PASSWORD') READPW('PASSWORD') UNINHIBIT | INHIBIT CODE('CODE') ATTEMPTS('NUMBER') AUTHORIZATION('ENTRYPOINT' 'STRING') OWNER('OWNERID') ALTER Page 21 ALTER TO('DATE') | FOR('DAYS') SHAREOPTIONS('CROSSREGION' 'CROSSSYSTEM') ERASE | NOERASE EXCEPTIONEXIT('MNAME') WRITECHECK | NOWRITECHECK DESTAGEWAIT | NODESTAGEWAIT RECORDSIZE('AVERAGE' 'MAXIMUM') KEYS('LENGTH' 'OFFSET') UNIQUEKEY | NONUNIQUEKEY FILE('DNAME') FREESPACE('CIPERCENT' 'CAPERCENT') BUFFERSPACE('SIZE') ADDVOLUMES('VOLSER' ...) REMOVEVOLUMES('VOLSER' ...) STAGE | BIND | CYLINDERFAULT UPGRADE | NOUPGRADE UPDATE | NOUPDATE EMPTY | NOEMPTY SCRATCH | NOSCRATCH CATALOG('CATNAME/PASSWORD') REQUIRED - 'ENTRYNAME' DEFAULTS - NONE ABBREVIATIONS - NOTE - IN ADDITION TO NORMAL TSO SHORT FORMS, THESE ARE ACCEPTED. NEWNAME NEWNM MASTERPW MRPW CONTROLPW CTLPW UPDATEPW UPDPW READPW RDPW MODULE MDLE STRING STRG RETENTION RETN UNINHIBIT UNINH SHAREOPTIONS SHR NOERASE NERAS EXCEPTIONEXIT EEXT WRITECHECK WCK NOWRITECHECK NWCK DESTAGEWAIT DSTGW NODESTAGEWAIT NDSTGW UNIQUEKEY UNQK NONUNIQUEKEY NUNQK FREESPACE FSPC BUFFERSPACE BUFSPC OR BUFSP ADDVOLUMES AVOL REMOVEVOLUMES RVOL CYLINDERFAULT CYLF UPGRADE UPG NOUPGRADE NUPG UPDATE UPD ALTER Page 22 ALTER NOUPDATE NUPD NOEMPTY NEMP NOSCRATCH NSCR OPERANDS - 'ENTRYNAME/PASSWORD' - SPECIFIES THE NAME OF THE ENTRY TO BE ALTERED. 'ENTRYNAME' - NAME OF THE ENTRY TO BE ALTERED. 'PASSWORD' - PASSWORD OF THE ENTRY TO BE ALTERED. REQUIRED - 'ENTRYNAME' NEWNAME('NEWNAME') - SPECIFIES THAT THE ENTRY TO BE ALTERED IS TO BE GIVEN A NEW NAME. 'NEWNAME' - NEW NAME FOR ENTRY TO BE ALTERED. NULLIFY(MASTERPW CONTROLPW UPDATEPW READPW OWNER AUTHORIZATION(MODULE|STRING) RETENTION CODE EXCEPTIONEXIT) - SPECIFIES THAT THE ATTRIBUTES IDENTIFIED BY THE KEYWORDS CODED AS SUBPARAMETERS ARE TO BE NULLIFIED. MASTERPW - MASTER PASSWORD IS TO BE NULLIFIED. CONTROLPW - CONTROL LEVEL PASSWORD IS TO BE NULLIFIED. UPDATEPW - UPDATE LEVEL PASSWORD IS TO BE NULLIFIED. READPW - READ LEVEL PASSWORD IS TO BE NULLIFIED. OWNER- OWNER IDENTIFICATION IS TO BE NULLIFIED. AUTHORIZATION(MODULE|STRING) - SPECIFIES THAT EITHER THE NAME OF THE USER SECURITY VERIFICATION ROUTINE (USVR) OR THE USER AUTHORIZATION RECORD IS TO BE NULLIFIED. MODULE - THE NAME OF THE USVR IS TO BE NULLIFIED. STRING - THE USER AUTHORIZATION RECORD IS TO BE NULLIFIED. RETENTION - THE RETENTION PERIOD IS TO BE NULLIFIED. CODE - THE CODE NAME USED FOR PROMPTING IS TO BE NULLIFIED. EXCEPTIONEXIT - THE EXCEPTIONEXIT IS TO BE NULLIFIED. MASTERPW('PASSWORD') - SPECIFIES A MASTER LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. 'PASSWORD' - MASTER LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. ALTER Page 23 ALTER CONTROLPW('PASSWORD') - SPECIFIES A CONTROL LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. 'PASSWORD' - CONTROL LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. UPDATEPW('PASSWORD') - SPECIFIES AN UPDATE LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. 'PASSWORD' - UPDATE LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. READPW('PASSWORD') - SPECIFIES A READ LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. 'PASSWORD' - READ LEVEL PASSWORD FOR THE ENTRY BEING DEFINED. UNINHIBIT - THE READ-ONLY RESTRICTION SET BY A PREVIOUS ALTER OR EXPORT COMMAND IS TO BE REMOVED. INHIBIT- THE ENTRY BEING ALTERED IS ONLY TO BE READ. CODE('CODE') - SPECIFIES A CODE NAME FOR THE ENTRY BEING DEFINED. 'CODE' - CODE NAME FOR THE ENTRY BEING DEFINED. ATTEMPTS('NUMBER') - SPECIFIES THE MAXIMUM NUMBER OF TIMES THE OPERATOR CAN TRY TO ENTER A CORRECT PASSWORD IN RESPONSE TO A PROMPTING MESSAGE. 'NUMBER' - MAXIMUM NUMBER OF TIMES THE OPERATOR CAN TRY TO ENTER A CORRECT PASSWORD IN RESPONSE TO A PROMPTING MESSAGE. AUTHORIZATION('ENTRYPOINT' 'STRING') - SPECIFIES THAT A USER-SECURITY-VERIFICATION ROUTINE (USVR) IS AVAILABLE FOR ADDITIONAL SECURITY VERIFICATION. 'ENTRYPOINT' - ENTRY POINT OF THE USVR. 'STRING' - INFORMATION TO BE PASSED TO THE USVR WHEN IT RECEIVES CONTROL TO VERIFY AUTHORIZATION. REQUIRED - 'ENTRYPOINT' ALTER Page 24 ALTER OWNER('OWNERID') - SPECIFIES THE IDENTIFICATION OF THE OWNER OF THE ENTRY BEING ALTERED. 'OWNERID' - IDENTIFICATION OF THE OWNER OF THE ENTRY BEING ALTERED. TO('DATE') - SPECIFIES THE DATE THROUGH WHICH THE ENTRY IS TO BE KEPT. 'DATE' - THE DATE (YYDDD) THROUGH WHICH THE ENTRY IS TO BE KEPT. FOR('DAYS') - SPECIFIES THE NUMBER OF DAYS FOR WHICH THE ENTRY IS TO BE KEPT. 'DAYS' - NUMBER OF DAYS FOR WHICH THE ENTRY IS TO BE KEPT. SHAREOPTIONS('CROSSREGION' 'CROSSSYSTEM') - SPECIFIES HOW A DATA OR INDEX COMPONENT OF A CLUSTER CAN BE SHARED. 'CROSSREGION' - SPECIFIES THE AMOUNT OF SHARING ALLOWED AMONG REGIONS. 'CROSSSYSTEM' - SPECIFIES THE AMOUNT OF SHARING ALLOWED AMONG SYSTEMS. REQUIRED - 'CROSSREGION' ERASE - THE DATA COMPONENT IS TO BE OVERWRITTEN WITH BINARY ZEROS WHEN ITS CATALOG ENTRY IS DELETED. NOERASE- THE DATA COMPONENT IS NOT TO BE OVERWRITTEN WITH BINARY ZEROS WHEN ITS CATALOG ENTRY IS DELETED. EXCEPTIONEXIT('MNAME') - SPECIFIES THE NAME OF THE USER MODULE TO BE GIVEN CONTROL WHEN AN EXCEPTION OCCURS DURING PROCESSING. 'MNAME'- NAME OF USER MODULE. WRITECHECK - THE DATA OR INDEX COMPONENT IS TO BE CHECKED BY A MACHINE ACTION CALLED 'WRITE-CHECK' WHEN A RECORD IS WRITTEN INTO IT. NOWRITECHECK - THE DATA OR INDEX COMPONENT IS NOT TO BE CHECKED BY A ALTER Page 25 ALTER MACHINE ACTION CALLED 'WRITE-CHECK' WHEN A RECORD IS WRITTEN INTO IT. DESTAGEWAIT - INDICATES THAT DESTAGING TO MASS STORAGE IS TO BE COMPLETED BEFORE CONTROL IS RETURNED FROM VSAM TO THE PROGRAM THAT ISSUES THE CLOSE MACRO. NODESTAGEWAIT - INDICATES THAT NOTIFICATION OF UNSUCCESSFUL DESTAGING TO MASS STORAGE IS TO BE MADE ONLY BY A MESSAGE TO THE OPERATOR AND TO THE MESSAGES (SYSPRINT) DATA SET. RECORDSIZE('AVERAGE' 'MAXIMUM') - SPECIFIES THE AVERAGE AND MAXIMUM LENGTHS, IN BYTES, OF THE RECORDS IN THE DATA COMPONENT. 'AVERAGE' - AVERAGE LENGTH OF THE RECORDS IN THE DATA COMPONENT. 'MAXIMUM' - MAXIMUM LENGTH OF THE RECORDS IN THE DATA COMPONENT. KEYS('LENGTH' 'OFFSET') - SPECIFIES THAT INFORMATION ABOUT THE KEY FIELD FOR KEY-SEQUENCED DATA FOLLOWS. 'LENGTH' - LENGTH OF THE KEY. 'OFFSET' - OFFSET OF THE KEY. UNIQUEKEY - SPECIFIES THAT THE ALTERNATE KEY MAY NOT RESOLVE INTO MORE THAN ONE PRIME KEY. NONUNIQUEKEY - SPECIFIES THAT THE ALTERNATE KEY MAY RESOLVE INTO MORE THAN ONE PRIME KEY. FILE('DNAME') - SPECIFIES THE NAME OF A DD STAMEMENT THAT IDENTIFIES THE ENTRY TO BE ALTERED. 'DNAME'- NAME OF A DD STATEMENT THAT IDENTIFIES THE ENTRY TO BE ALTERED. FREESPACE('CIPERCENT' 'CAPERCENT') - SPECIFIES THE AMOUNT OF SPACE THAT IS TO BE LEFT FREE ALTER Page 26 ALTER AFTER ANY ALLOCATION AND AFTER ANY SPLIT OF CONTROL INTERVALS (CIPERCENT) AND CONTROL AREAS (CAPERCENT). 'CIPERCENT' - PERCENTAGE OF SPACE THAT IS TO BE LEFT FREE IN EACH CONTROL INTERVAL. 'CAPERCENT' - PERCENTAGE OF SPACE THAT IS TO BE LEFT FREE IN EACH CONTROL AREA. REQUIRED - 'CIPERCENT' BUFFERSPACE('SIZE') - SPECIFIES THE MINIMUM SPACE TO BE PROVIDED FOR BUFFERS. 'SIZE' - AMOUNT OF SPACE TO BE PROVIDED FOR BUFFERS. ADDVOLUMES('VOLSER' ...) - SPECIFIES VOLUMES TO BE ADDED TO THE LIST OF OVERFLOW (CANDIDATE) VOLUMES. 'VOLSER' - VOLUME SERIAL NUMBER OF VOLUME TO BE ADDED TO THE LIST OF OVERFLOW (CANDIDATE) VOLUMES. REMOVEVOLUMES('VOLSER' ...) - SPECIFIES VOLUMES TO BE REMOVED FROM THE LIST OF CANDIDATE VOLUMES. 'VOLSER' - VOLUME SERIAL NUMBER OF VOLUME TO BE REMOVED FROM THE LIST OF CANDIDATE VOLUMES. STAGE - INDICATES THAT THE CLUSTER OR COMPONENT IS TO BE STAGED FROM MASS STORAGE TO A DIRECT ACCESS STORAGE STAGING DRIVE WHEN THE CLUSTER OR COMPONENT IS OPENED. BIND - INDICATES THAT THE CLUSTER OR COMPONENT IS NOT ONLY TO BE STAGED, BUT ALSO TO BE BOUND, THAT IS, RETAINED ON THE DIRECT ACCESS STORAGE STAGING DRIVE WHEN THE CLUSTER OR COMPONENT IS OPENED. CYLINDERFAULT - INDICATES THAT THE CLUSTER OR COMPONENT IS NOT TO BE STAGED WHEN IT IS OPENED, BUT THAT DATA FROM IT IS TO BE STAGED AS A PROCESSING PROGRAM NEEDS IT. UPGRADE- SPECIFIES THAT THE ALTERNATE INDEX IS TO BE KEPT UP TO DATE WITH ITS BASE CLUSTER AUTOMATICALLY BY VSAM. ALTER Page 27 ALTER NOUPGRADE - SPECIFIES THAT THE ALTERNATE INDEX IS NOT TO BE KEPT UP AUTOMATICALLY BY VSAM. UPDATE - INDICATES THAT SPECIFICATION OF THE PATH NAME IN JCL CAUSES ALLOCATION OF THE ENTIRE UPGRADE SET. NOUPDATE - INDICATES THAT SPECIFICATION OF THE PATH NAME IN JCL CAUSES ONLY THE BASE CLUSTER TO BE ALLOCATED. EMPTY - ALL OF THE GENERATION DATA SETS ARE TO BE UNCATALOGED WHEN THE MAXIMUM NUMBER OF GDG'S HAVE BEEN CATALOGED. NOEMPTY- ONLY THE OLDEST GENERATION DATA SET IS TO BE UNCATALOGED WHEN THE MAXIMUM NUMBER OF GDG'S HAVE BEEN CATALOGED. SCRATCH- GENERATION DATA SETS ARE TO BE REMOVED FROM THE VTOC OF THE VOLUME ON WHICH THEY RESIDE WHEN THEY ARE UNCATALOGED. NOSCRATCH - GENERATION DATA SETS ARE NOT TO BE REMOVED FROM THE VTOC OF THE VOLUME ON WHICH THEY RESIDE WHEN THEY ARE UNCATALOGED. CATALOG('CATNAME/PASSWORD') - SPECIFIES THE CATALOG LOCATION OF THE ENTRY TO BE ALTERED. 'CATNAME' - NAME OF THE CATALOG THAT CONTAINS THE ENTRY. 'PASSWORD' - MASTER PASSWORD OF THE CATALOG THAT CONTAINS THE ENTRY TO BE ALTERED. REQUIRED - 'CATNAME' ALTPSWD Page 28 ALTPSWD COMMAND NAME - ALTPSWD FUNCTION - THE ALTPSWD COMMAND IS USED TO CHANGE THE PASSWORD OF YOUR ACCOUNT. SYNTAX - ALTPSWD REQUIRED - NONE DEFAULTS - NONE OPERANDS - NONE NOTE:THE NEW PASSWORD WILL BE REQUESTED AFTER THE COMMAND ALTPSWD IS GIVEN. IF THE CARRIAGE RETURN IS USED OR INVALID ALPHAMERIC CHARACTERS ARE ENTERED WHEN THE PASSWORD IS REQUESTED, YOUR PASSWORD WILL NOT BE ALTERED, AND YOU WILL BE PROMPTED TO ENTER A VALID STRING. COMMAND NAME - ARCHIVE FUNCTION - THE ARCHIVE COMMAND IS USED TO REQUEST THAT DATA SETS BE COPIED FROM ONLINE DISK STORAGE IN THE SYSTEM ARCHIVES. NOTE THAT THIS COMMAND ONLY FLAGS THE DATA SET FOR ARCHIVAL; THE ACTUAL ARCHIVAL PROCESS IS PERFORMED BY REGULARLY SCHEDULED MAINTENENCE ROUTINES RUN DURING OFF HOURS. SYNTAX - ARCHIVE ('DSLIST') REQUIRED - 'DSLIST' DEFAULTS - NONE OPERANDS - 'DSLIST' - SPECIFIES A LIST OF DATA SETS TO BE ARCHIVED. THE TSO '*' WILD CARD CONSTRUCTION IS SUPPORTED. ASM Page 29 ASM COMMAND NAME - ASM FUNCTION - THE ASM COMMAND INVOKES THE ASSEMBLER (G) COMPILER. SYNTAX - ASM 'SOURCE-DSNAME' ALIGN/NOALIGN BATCH/NOBATCH ESD/NOESD EXECUTE/NOEXECUTE EXTIME('SECONDS') LIB('LIBRARY-DSLIST')/NOLIB LINECOUNT('LINES') LIST/NOLIST/FULLLIST LOAD('OBJECT-DSNAME')/NOLOAD LREF/NOLREF LSETC('LENGTH') MACLIB/NOMACLIB NUMBER/NONUMBER PRINT('PRINT-DSNAME'/*)/NOPRINT/SYSPRINT('CLASS') RENT/NORENT RLD/NORLD SPACE('SIZE') STMT/NOSTMT SYSPARM('STRING') TERM/NOTERM TEST/NOTEST UMAP/NOUMAP UPDATE('UPDATE-DSNAME')/NOUPDATE XREF(FULL/SHORT)/NOXREF/FULLXREF(FULL/SHORT) REQUIRED - 'SOURCE-DSNAME' DEFAULTS - ALIGN, NOBATCH, NOESD, NOEXECUTE, EXTIME(5), NOLIB, LINECOUNT(55), LIST, LOAD, LREF, LSETC(8), MACLIB, NUMBER, NOPRINT, NORENT, NORLD, SPACE(MAX-24K), NOSTMT, NOTEST, NOUMAP, NOUPDATE, FULLXREF(SHORT) - 'CLASS' IS ASSUMED TO BE 'A' IF SYSPRINT IS ENTERED WITHOUT A SUBFIELD. NOTE- PRINT(*) CAUSES NOTERM TO BE ASSUMED REGARDLESS OF WHAT IS SPECIFIED ON THE COMMAND LINE. OPERANDS - 'SOURCE-DSNAME' - THE NAME OF THE DATA SET CONTAINING THE ASSEMBLY LANGUAGE SOURCE PROGRAM. ALIGN- ALL ALIGNMENT ERRORS ARE FLAGGED. NOALIGN - ONLY ALIGNMENT ERRORS THAT INVOLVE THE FETCHING OF AN INSTRUCTION ARE FLAGGED. BATCH- THE ASSEMBLER ASSUMES THAT THERE ARE SEVERAL SOURCE DECKS, DELIMITED BY 'END' STATEMENTS. NOBATCH - THE ASSEMBLER PROCESSES ONE SOURCE DECK. ASM Page 30 ASM ESD- THE EXTERNAL SYMBOL DICTIONARY IS PRINTED IF 'PRINT' IS SPECIFIED. NOESD- THE EXTERNAL SYMBOL DICTIONARY IS NOT PRINTED. EXECUTE - THE OBJECT PROGRAM IS EXECUTED AFTER ASSEMBLY. NOEXECUTE - THE OBJECT PROGRAM IS NOT EXECUTED. EXTIME('SECONDS') - SPECIFIES A LIMIT ON THE CPU TIME THE OBJECT PROGRAM CAN USE WHEN 'EXECUTE' IS SPECIFIED. LIB('LIBRARY-DSLIST') - SPECIFIES A LIST OF DATA SETS WHICH ARE TO BE USED AS MACRO LIBRARIES. NOLIB- NO LIBRARY DATA SETS ARE TO BE USED. LINECOUNT('LINES') - SPECIFIES THE NUMBER OF LINES PER PAGE TO BE PRINTED WHEN 'PRINT' IS SPECIFIED. LIST - A SOURCE LISTING IS PRINTED WHEN 'PRINT' IS SPECIFIED. NOLIST - NO SOURCE LISTING IS TO BE PRINTED. FULLLIST - A LISTING OF EACH LIBRARY MACRO USED, AS WELL AS A SOURCE LISTING, IS PRINTED WHEN 'PRINT' IS SPECIFIED. LOAD('OBJECT-DSNAME') - AN OBJECT DATA SET IS PRODUCED WITH THE SPECIFIED NAME. NOLOAD - NO OBJECT DATA SET IS PRODUCED. LREF - A LITERAL CROSS-REFERENCE IS PRINTED IF 'PRINT' IS SPECIFIED. NOLREF - NO LITERAL CROSS-REFERENCE IS PRINTED. ASM Page 31 ASM LSETC('LENGTH') - SPECIFIES THE MAXIMUM LENGTH OF SETC VARIABLES. MACLIB - DATA SET 'SYS1.MACLIB' IS TO BE CONCATENATED AFTER THE DATA SETS SPECIFIED IN THE 'LIB' PARAMETER. NOMACLIB - DATA SET 'SYS1.MACLIB' IS NOT TO BE AUTOMATICALLY ALLOCATED. NUMBER - THE SEQUENCE NUMBER FIELD OF ERRONEOUS SOURCE STATEMENTS IS PRINTED WHEN 'TERM' IS SPECIFIED. NONUMBER - THE SEQUENCE FIELD OF SOURCE STATEMENTS IS NOT PRINTED. PRINT('PRINT-DSNAME'/*) - AN ASSEMBLY LISTING IS PRODUCED WITH THE SPECIFIED DATA SET NAME OR AT THE TERMINAL. NOPRINT - NO ASSEMBLY LISTING IS PRODUCED. SYSPRINT('CLASS') - THE ASSEMBLY LISTING IS TO BE PRINTED ON THE HIGH-SPEED LINE PRINTER. 'CLASS' - IS THE SYSOUT CLASS. RENT - POSSIBLE REENTERABILITY ERRORS ARE FLAGGED. NORENT - POSSIBLE REENTERABILITY ERRORS ARE NOT FLAGGED. RLD - THE RELOCATION DICTIONARY IS PRINTED WHEN 'PRINT' IS SPECIFIED. NORLD- THE RELOCATION DICTIONARY IS NOT PRINTED. SPACE('SIZE') - SPECIFIES THE AMOUNT OF STORAGE THE ASSEMBLER WILL USE. STMT - THE STATEMENT NUMBER OF ERRONEOUS STATEMENTS IS PRINTED WHEN 'TERM' IS SPECIFIED. ASM Page 32 ASM NOSTMT - THE STATEMENT NUMBER OF ERRONEOUS STATEMENTS IS NOT PRINTED. SYSPARM('STRING') - SETS THE VALUE OF THE '&SYSPARM' VARIABLE. TERM - CONDENSED DIAGNOSTIC MESSAGES ARE TO BE PRINTED AT THE TERMINAL. NOTERM - CONDENSED DIAGNOSTIC MESSAGES ARE NOT PRINTED. TEST - THE SYMBOL TABLE IS INCLUDED IN THE OBJECT MODULE FOR USE WITH THE 'TEST' COMMAND. NOTEST - THE SYMBOL TABLE IS NOT INCLUDED IN THE OBJECT MODULE. UMAP - A MAP OF REGISTERS IN 'USING', 'DROP', AND 'POP USING' STATEMENTS IS PRINTED WHEN 'PRINT' IS SPECIFIED. NOUMAP - NO REGISTER MAP IS PRINTED. UPDATE('UPDATE-DSNAME') - SPECIFIES THE NAME OF A DATA SET WHICH CONTAINS MODIFICATIONS TO BE MADE TO THE SOURCE DURING ASSEMBLY. NOUPDATE - NO MODIFICATIONS ARE PROVIDED. FULLXREF(FULL/SHORT) - A SYMBOL CROSS-REFERENCE IS PRINTED WHEN 'PRINT' IS SPECIFIED. FULL - ALL SYMBOLS ARE TO BE INCLUDED IN THE CROSS-REFERENCE. SHORT- ONLY THOSE SYMBOLS THAT HAVE BEEN REFERENCED ARE TO BE INCLUDED IN THE CROSS-REFERENCE. XREF(FULL/SHORT) - A SYMBOL CROSS REFERENCE IS TO BE PRINTED IN CONDENSED FORM. NOXREF - NO SYMBOL CROSS-REFERENCE IS PRINTED. ASMF Page 33 ASMF COMMAND NAME - ASMF FUNCTION - THE ASMF COMMAND INVOKES THE IBM VS ASSEMBLER. SYNTAX - ASMF'SOURCE-DSNAME' LIB('LIBRARY-DSNAME')/NOLIB MACLIB/NOMACLIB ALOGIC/NOALOGIC ESD/NOESD FLAG('FLAGN') YFLAG/NOYFLAG LINECOUNT('LINES') PRINT('PRINT-DSNAME'/*)/NOPRINT/SYSPRINT('CLASS') MCALL/NOMCALL MLOGIC/NOMLOGIC RLD/NORLD LIBMAC/NOLIBMAC XREF(FULL/SHORT)/NOXREF LOAD('OBJECT-DSNAME')/NOLOAD TEST/NOTEST NUMBER/NONUMBER STMT/NOSTMT TERM/NOTERM ALIGN/NOALIGN BUFSIZE(STD/MIN) RENT/NORENT SYSPARM('STRING') REQUIRED - 'SOURCE-DSNAME' DEFAULTS - LIB('SYS1.MACLIB') ALOGIC ESD FLAG(0) YFLAG LINECOUNT(55) NOPRINT NOMCALL NOMLOGIC RLD NOLIBMAC XREF(FULL) LOAD NOTEST NUMBER STMT TERM ALIGN BUFSIZE(STD) NORENT SYSPARM() - 'CLASS' IS ASSUMED TO BE 'A' IF SYSPRINT IS ENTERED WITHOUT A SUBFIELD. NOTE- PRINT(*) CAUSES NOTERM TO BE ASSUMED REGARDLESS OF WHAT IS SPECIFIED ON THE COMMAND LINE. OPERANDS - 'SOURCE-DSNAME' - THE NAME OF THE DATA SET CONTAINING THE ASSEMBLY LANGUAGE SOURCE PROGRAM. ASMF Page 34 ASMF LIB('LIBRARY-DSLIST') - SPECIFIES A LIST OF DATA SETS WHICH ARE TO BE USED AS MACRO LIBRARIES. NOLIB- NO LIBRARY DATA SETS ARE TO BE USED. MACLIB - DATA SET 'SYS1.MACLIB' IS TO BE CONCATENATED AFTER THE DATA SETS SPECIFIED IN THE 'LIB' PARAMETER. NOMACLIB - DATA SET 'SYS1.MACLIB' IS NOT TO BE AUTOMATICALLY ALLOCATED. ALOGIC - CONDITIONAL ASSEMBLY STATEMENTS PROCESSED IN OPEN CODE ARE LISTED. NOALOGIC - THE ALOGIC OPTION IS SUPPRESSED. ESD - THE EXTERNAL SYMBOL DICTIONARY IS LISTED. NOESD- NO ESD LISTING IS PRINTED. FLAG('FLAGN') - DIAGNOSTIC MESSAGES AND MNOTE MESSAGES BELOW SEVERITY CODE 'FLAGN' WILL NOT APPEAR IN THE LISTING. YFLAG- RELOCATABLE Y-TYPE CONSTANTS WILL BE FLAGGED. NOYFLAG - THE YFLAG OPTION IS SUPPRESSED. LINECOUNT('LINES') - SPECIFIES THE NUMBER OF LINES TO BE PRINTED BETWEEN HEADINGS IN THE LISTING. PRINT('PRINT-DSNAME'/*) - AN ASSEMBLY LISTING IS PRODUCED WITH THE SPECIFIED DATA SET NAME OR AT THE TERMINAL. NOPRINT - NO ASSEMBLY LISTING IS PRODUCED. SYSPRINT('CLASS') - THE ASSEMBLY LISTING IS TO BE PRINTED ON THE HIGH-SPEED PRINTER, WITH THE GIVEN SYSOUT CLASS. ASMF Page 35 ASMF MCALL- INNER MACRO INSTRUCTIONS ENCOUNTERED DURING MACRO GENERATION ARE LISTED FOLLOWING THEIR RESPECTIVE OUTER MACRO INSTRUCTIONS. NOMCALL - THE MCALL OPTION IS SUPPRESSED. MLOGIC - ALL STATEMENTS OF A MACRO DEFINITION PROCESSED DURING MACRO GENERATION A LISTED AFTER THE MACRO INSTRUCTION. NOMLOGIC - THE MLOGIC OPTION IS SUPPRESSED. RLD - THE ASSEMBLER PRODUCES THE RELOCATION DICTIONARY AS PART OF THE LISTING. NORLD- THE RLD IS NOT PRINTED. LIBMAC - THE MACRO DEFINITIONS READ FROM THE MACRO LIBRARIES AND ANY ASSEMBLER STATEMENTS FOLLOWING THE LOGICAL END STATEMENT ARE LISTED AFTER THE LOGICAL END STATEMENT. NOLIBMAC - THE LIBMAC OPTION IS SUPPRESSED. XREF(FULL/SHORT) - THE ASSEMBLER LISTING WILL CONTAIN A CROSS REFERENCE TABLE OF SYMBOLS AND LITERALS USED IN THE ASSEMBLY. FULL- ALL SYMBOLS USED IN THE ASSEMBLY WILL BE CROSS REFERENCED. SHORT - ALL SYMBOLS THAT ARE REFERENCED IN THE ASSEMBLY WILL BE CROSS REFERENCED. NOXREF - NO CROSS REFERENCE TABLES ARE PRINTED. LOAD('OBJECT-DSNAME') - AN OBJECT DATA SET IS PRODUCED WITH THE SPECIFIED NAME. NOLOAD - NO OBJECT DATA SET IS PRODUCED. TEST - THE SYMBOL TABLE IS INCLUDED IN THE OBJECT DATA SET FOR USE WITH THE TEST COMMAND. ASMF Page 36 ASMF NOTEST - THE TEST OPTION IS SUPPRESSED. NUMBER - THE LINE NUMBER FIELD OF THE INPUT CARDS IS WRITTEN ON THE TERMINAL FOR STATEMENTS FOR WHICH DIAGNOSTIC INFORMATION IS GIVEN. NONUMBER - THE NUMBER OPTION IS SUPPRESSED. STMT - THE STATEMENT NUMBER ASSIGNED BY THE ASSEMBLER IS WRITTEN ON THE TERMINAL FOR STATEMENTS FOR WHICH DIAGNOSTIC INFORMATION IS GIVEN. NOSTMT - THE STMT OPTION IS SUPPRESSED. TERM - THE ASSEMBLER WRITES DIAGNOSTIC INFORMATION ON THE TERMINAL. NOTERM - THE TERM OPTION IS SUPPRESSED. ALIGN- ALL DATA IS ALIGNED ON THE PROPER BOUNDARY IN THE OBJECT MODULE, AND THE ASSEMBLER CHECKS STORAGE ADDRESSES FOR ALIGNMENT VIOLATIONS. NOALIGN - THE ALIGN OPTION IS SUPPRESSED. BUFSIZE(STD/MIN) - SPECIFIES THE SIZE OF THE BUFFERS FOR THE ASSEMBLER'S UTILITY DATA SETS. STD- THE BUFFER SIZE THAT GIVES THE OPTIMUM PERFORMANCE IS CHOSEN. MIN- THE ASSEMBLER USES THE MINIMUM BUFFER SIZE FOR EACH OF THE UTILITY DATA SETS. RENT - THE ASSEMBLER CHECKS YOUR PROGRAM FOR A POSSIBLE VIOLATION OF PROGRAM REENTERABILITY. NORENT - THE RENT OPTION IS SUPPRESSED. SYSPARM('STRING') - 'STRING' IS THE VALUE ASSIGNED TO THE SYSTEM VARIABLE SYMBOL &SYSPARM. ASSIST Page 37 ASSIST COMMAND NAME - ASSIST FUNCTION - THE ASSIST COMMAND IS USED TO INVOKE THE ASSIST ASSEMBLER. SYNTAX - ASSIST 'SOURCE-DSNAME' PRINT('PRINT-DSNAME') LIB('MACRO-LIBRARY') REQUIRED - 'SOURCE-DSNAME' DEFAULTS - PRINT(*) LIB('''UICCAPP.ASSIST.MACLIB''') OPERANDS - 'SOURCE-DSNAME' - THE NAME OF THE DATA SET CONTAINING THE PROGRAM TO BE ASSEMBLED BY THE ASSIST ASSEMBLER. PRINT- 'PRINT-DSNAME' - THE NAME OF THE DATA SET TO WHICH OUTPUT PRINTING IS TO BE SENT. IF * IS USED, THE OUTPUT WILL GO TO THE TERMINAL, AND THE SOURCE STATEMENTS AND XREF LISTING WILL NOT BE GIVEN. LIB - 'MACRO-LIBRARY' - THE NAME OF THE PARTITIONED DATASET, OR LIST OF PARTITIONED DATASETS TO BE USED AS A MACRO LIBRARY. NOTE - IF A LIST OF DATASETS IS USED, THE LIST MUST BE CONTAINED IN QUOTES. IF A DATASET IS TO BE FULLY QUALIFIED, TWO ADDITIONAL QUOTES ARE NEEDED BEFORE AND AFTER THE DATASET NAME. FOR EXAMPLE, TO CONCATENATE MYLIB.ASM TO THE STANDARD MACRO LIBRARY, YOU WOULD USE LIB('MYLIB.ASM,''UICCAPP.ASSIST.MACLIB''') COMMAND NAME - ATTRIB FUNCTION- THE ATTRIB COMMAND ALLOWS DCB PARAMETERS TO BE DYNAMICALLY INTRODUCED AND NAMED FOR USE WITH A SUBSEQUENT ALLOCATE COMMAND. ATTRIB Page 38 ATTRIB SYNTAX- ATTRIB ATTR-LIST-NAME BFALN('BUFFER BOUNDARY ALLIGNMENT') BFTEK('BUFFER TECHNIQUE') BLKSIZE('BLOCK SIZE') BUFL('BUFFER LENGTH') BUFNO('NUMBER OF BUFFERS') BUFOFF('BUFFER OFFSET') DEN('MAGNETIC TAPE DENSITY') DIAGNS('TRACE OPTION') DSORG('DATA SET ORGANIZATION') EROPT('ERROR OPTION') KEYLEN('KEY LENGTH') LIMCT('LIMCT LENGTH') LRECL('LOGICAL RECORD LENGTH') NCP('MAX. NO. R/W MACROS') OPTCD('OPTIONAL SERVICES') RECFM('RECORD FORMAT') TRTCH('RECORDING TECHNIQUE') INPUT OUTPUT EXPDT('YYDDD') RETPD('NNNN') REQUIRED - ATTR-LIST-NAME ALIAS - ATTR DEFAULTS - NONE NOTE - ATTRIBUTE LISTS ARE KNOWN TO THE SYSTEM FOR THE DURATION OF A TERMINAL SESSION OR UNTIL RELEASED VIA THE FREE COMMAND - BEFORE USING THIS COMMAND THE USER SHOULD BE FAMILIAR WITH THE PROPER COMBINATIONS AND USAGE OF DCB PARAMETERS - ALL VALUES MUST BE SEPARATED BY BLANKS OR COMMAS OPERANDS - ATTR-LIST-NAME - NAME TO BE ASSIGNED TO THE ATTRIBUTES. THIS NAME WILL BE THE NAME SPECIFIED ON THE ALLOCATE OR FREE COMMAND. BFALN - BUFFER BOUNDARY ALIGNMENT D--DOUBLE WORD BOUNDARY F--FULL WORD BOUNDARY BFTEK - TYPE OF BUFFERING A--AUTOMATIC RECORD AREA CONSTRUCTION E--EXCHANGE BUFFERING R--RECORD BUFFERING S--SIMPLE BUFFERING BLKSIZE - BLOCK SIZE (0 TO 32760 VALUE) BUFL - BUFFER LENGTH (0 TO 32760 VALUE) BUFNO - NUMBER OF BUFFERS (0 TO 255 VALUE) ATTRIB Page 39 ATTRIB BUFOFF - BLOCK PREFIX LENGTH (0 TO 99 VALUE OR CHARACTER L) L--BLOCK PREFIX FIELD IS FOUR BYTES LONG AND CONTAINS THE BLOCK LENGTH DEN - MAGNETIC TAPE DENSITY 0--200 BITS-PER-INCH FOR 7-TRACK TAPE 1--556 BITS-PER-INCH FOR 7-TRACK TAPE 2--800 BITS-PER-INCH FOR 7 AND 9-TRACK TAPES 3--1600 BITS-PER-INCH FOR 9-TRACK TAPE 4--6250 BITS-PER-INCH FOR 9-TRACK TAPE WITH 6250 BPI FEATURE DIAGNS - REQUESTS THE OPEN/CLOSE/EOV TRACE OPTION TRACE--GIVES A MODULE BY MODULE TRACE OF OPEN/ CLOSE/EOV'S WORKAREA AND USER'S DCB DSORG - DATA SET ORGANIZATION DA--DIRECT ACCESS DAU--DIRECT ACCESS UNMOVABLE PO--PARTITIONED ORGANIZATION POU--PARTITIONED ORGANIZATION UNMOVABLE PS-PHYSICAL SEQUENTIAL PSU--PHYSICAL SEQUENTIAL UNMOVABLE EROPT - ERROR OPTION ABE--ABNORMAL END OF TASK ACC--ACCEPT BLOCK CAUSING ERROR SKP--SKIP BLOCK CAUSING ERROR KEYLEN - KEY LENGTH (0 TO 255 VALUE) LIMCT - NUMBER OF BLOCKS OR TRACKS TO BE SEARCHED FOR A BLOCK OR AVAILABLE SPACE (0 TO 32760 VALUE) LRECL - LOGICAL RECORD LENGTH (0 TO 32760 VALUE OR CHARACTER X) X--LRECL VALUE EXCEEDS 32756 FOR VARIABLE-LENGTH SPANNED RECORDS PROCESSED UNDER QSAM NCP - MAXIMUM NUMBER OF READ/WRITE MACROS BEFORE A CHECK (0 TO 99 VALUE) ATTRIB Page 40 ATTRIB OPTCD - OPTIONAL SERVICES CODES A--ACTUAL DEVICE ADDRESSES PRESENTED IN READ AND WRITE MACRO INSTRUCTIONS B--END-OF-FILE RECOGNITION DISREGARDED FOR TAPES C--CHAINED SCHEDULING IS TO BE USED E--EXTENDED SEARCH FOR BLOCK OR AVAILABLE SPACE F--FEEDBACK MAY BE REQUESTED IN READ AND WRITE MACRO INSTRUCTIONS H--CHECK FOR AND BYPASS ANY DOS CHECKPOINT RECORDS FOUND ON A DOS TAPE INPUT FILE Q--ANSI TRANSLATE T--REQUESTS USER TOTALING FACILITY W--REQUESTS A VALIDITY CHECK FOR WRITE OPERATIONS ON DIRECT ACCESS DEVICES Z--FOR MAGNETIC TAPE INPUT, REQUESTS THE CONTROL PROGRAM TO SHORTEN ERROR RECOVERY PROCEDURE RECFM - RECORD FORMAT A--ASA PRINTER CHARACTERS B--BLOCKED D--VARIABLE LENGTH ASCII RECORDS F--FIXED M--MACHINE CONTROL CHARACTER S--STANDARD BLOCKS T--TRACK OVERFLOW U--UNDEFINED V--VARIABLE TRTCH - RECORDING TECHNIQUE FOR 7-TRACK TAPE C--DATA CONVERSION, WITH ODD PARITY AND NO TRANSLATION E--EVEN PARITY, WITH NO DATA CONVERSION AND NO TRANSLATION ET--EVEN PARITY AND NO CONVERSION, WITH BCD TO EBCDIC TRANSLATION WHEN READING AND EBCDIC TO BCD WHEN WRITING T--ODD PARITY AND NO CONVERSION, WITH BCD TO EBCDIC TRANSLATION WHEN READING AND EBCDIC TO BCD WHEN WRITING INPUT - SPECIFIES THAT THE DATA SET IS TO BE PROCESSED FOR INPUT ONLY OUTPUT - SPECIFIES THAT THE DATA SET IS TO BE PROCESSED FOR OUTPUT ONLY ATTRIB Page 41 ATTRIB EXPDT - DATA SET EXPIRATION DATE (YYDDD) RETPD - DATA SET RETENTION PERIOD (NNNN) COMMAND NAME - CALC FUNCTION - THE CALC COMMAND IS A DESK CALCULATOR PROGRAM WHICH DEMONSTRATES SOME OF THE CAPABILITIES OF CLISTS (THE CALC COMMAND PROCESSOR IS ITSELF A SHORT CLIST). SYNTAX - CALC CALC WILL PROMPT WITH A QUESTION MARK. ENTER A NUMERIC EXPRESSION OR 'END'. OPERANDS - ALL COMPUTATIONS USE INTEGER ARITHMETIC. THE FOLLOWING OPERATORS ARE ACCEPTED (IN INCREASING ORDER OF PRECEDENCE): + ADDITION - SUBTRACTION * MULTIPLICATION / DIVISION ** EXPONENTIATION // REMAINDER (MODULAR ARITHMETIC) COMMAND NAME - CALL FUNCTION THE CALL COMMAND LOADS AND EXECUTES PROGRAMS IN EXECUTABLE FORM. SYNTAX - CALL 'DSNAME(MEMBER)' ''PARM'' REQUIRED EITHER DSNAME OR MEMBER NAME OR BOTH. DEFAULTS USERID.LOAD IF NO DATASET NAME. TEMPNAME IF NO MEMBER NAME SPECIFIED. CALL Page 42 CALL OPERANDS - 'DSNAME(MEMBER)' - NAME OF PARTITIONED DATA SET AND THE MEMBER WHICH IS TO BE EXCECUTED ''PARM'' - SPECIFIES A PARAMETER STRING (UP TO 100 CHARACTERS) PASSED TO THE PROGRAM TO BE EXECUTED. COMMAND NAME - CATLG FUNTION - THE CATLG COMMAND CATALOGS THE OPERAND DATA SET. SYNTAX - CATLG 'DSNAME' VOL('VOLUME') REQUIRED - 'DSNAME' VOL('VOLUME') DEFAULTS - NONE ALIASES - NONE OPERANDS - 'DSNAME' - NAME OF THE DATA SET TO BE CATALOGGED. 'VOLUME' - NAME OF THE VOLUME ON WHICH DATA SET RESIDES. SUBCOMMANDS - NONE COMMAND NAME - CC Function - The CC command invokes the C/370 compiler and Assembler (G) to compile a program written in the C language. CC Page 43 CC Syntax - CC 'name' ASM Required - 'name' Defaults - '.text' is always added to the end of 'name' NOTE - 'name' may not be entered in apostrophes. NOTE - If the first character of the first line of the source data set is a sharp (#), the C preprocessor will be invoked before the compiler. Operands - 'name' - The name of the unnnumberd text data set containing the C source program. This name is also used by the compiler to generate control section (CSECT) names. ASM - The intermediate assembly language data set is to be retained, and the assembler is not to be invoked. COMMAND NAME - COMPARE Function - The COMPARE command compares two data sets and prints out the lines that don't match in both data sets. Syntax - COMPARE'data set#1' 'data set#2' NUM/NONUM NOPAD/PAD('character') OUTFILE('ddname')/SYSOUT('class') STACKSIZE('size') required- 'data set#1' 'data set#2' defaults- NUM, NOPAD, STACKSIZE(20) Note -If for some reason 'STACKSIZE' cannot be raised large enough for 'COMPARE' to complete because your TSO region is too small, you can try running 'COMPARE' using batch(tmp) for more region. Operands - 'data set#1' - The name of first data set to be compared. 'data set#2' - The name of second data set to be compared. COMPARE Page 44 COMPARE NUM - The data sets are to be considered numbered. NONUM - The data sets are NOT to be considered numbered. Data sets that are 'U' format or have machine or ansi control characters are considered 'NONUM' regardless of whether 'NUM' or 'NONUM' was entered. Any particular line whose length is too short to normally contain line numbers, less than eight for recfm=f(b) or less than twelve for recfm=v(b), will temporarily be considered 'NONUM' for that particular line regardless of whether the data set was considered to have line numbers or not. 'NONUM' lines will have relative line numbers inserted for ease of reading and future search. NOPAD - This specifies that if the records being compared are not of identical length, then no padding of characters will take place and the lines will be considered mis-matched on the basis of unequal lengths. PAD('character') - This specifies, if used, that if the records being compared are not of identical length, then 'character' will be used to pad the shorter record with the specified character to equal the length of the longer record. 'Character' is that character used for padding. It can be entered as a quoted, unquoted, or hexadecimal string constant ('1',1,x'F1', for example). The only exception is that a blank must not be entered unquoted (ie. either it must be quoted or it must be entered as it's hexadecimal equivalent, x'40'). If more than one character is entered, 'COMPARE' will accept the character string, but will use only the first character for a pad character, and will print a warning message informing the user of such. If 'PAD' is entered but no 'character' is supplied, then a blank is assumed. OUTFILE('ddname') - Requests that output be sent to a file rather than to the terminal. 'Ddname' specifies the ddname associated with that file. STACKSIZE('size') - The maximum number of consecutive non-matching lines for either data set which will be COMPARE Page 45 COMPARE put on a 'STACK' to be examined with other lines found later in the other data set before 'COMPARE' stops with a 'STACK' overflow. SYSOUT('class') - Specifies that output is to routed to 'SYSOUT' instead of to the terminal. 'Class' specifies the class of output preferred. If 'SYSOUT' is entered but no 'class' is supplied, then 'a' is assumed. COMMAND NAME - COMPRESS FUNCTION - THE COMPRESS COMMAND IS USED TO COMPRESS A PARTITIONED DATA SET. THE COMPRESS COMMAND DOES NOT RELEASE THE SPACE WHICH IS FREED AFTER THE COMPRESS UNLESS RELEASE IS SPECIFIED. SYNTAX - COMPRESS 'DSNAME' PRINT('DSNAME')/NOPRINT RELEASE REQUIRED - 'DSNAME' DEFAULTS - PRINT(*) ALIASES- NONE OPERANDS - 'DSNAME' - THE NAME OF THE INPUT PARTITIONED DATA SET TO BE COMPRESSED. PRINT('DSNAME') - SPECIFIES THE DATASET NAME INTO WHICH THE COMPRESS LISTING WILL BE PRODUCED. NOPRINT- NO COMPRESS LISTING WILL BE PRODUCED. RELEASE- RELEASE UNUSED SPACE AFTER COMPRESS. COPY Page 46 COPY COMMAND NAME - COPY FUNCTION- THE COPY COMMAND IS USED TO DUPLICATE A SEQUENTIAL OR PARTITIONED DATA SET OR A MEMBER OF A PARTITIONED DATA SET, TO ADD A MEMBER TO AN EXISTING PARTITIONED DATA SET, OR TO MERGE TWO PARTITIONED DATA SETS. SYNTAX- COPY 'DSNAME1' 'DSNAME2' RENUM('BEGIN INTEGER' 'INCREMENT') NUM('BEGIN COLUMN' 'FIELD LENGTH') OR NONUM NUM2('BEGIN COLUMN' 'FIELD LENGTH') LRECL(RECORDSIZE) BLOCK(BLOCKSIZE) RECFM(U/V/F/D) ASCII NOTE - U MAY BE FOLLOWED BY T. V MAY BE FOLLOWED BY B/T/BT. F MAY BE FOLLOWED BY B/S/T/BS/BT/ST/BST. D MAY BE FOLLOWED BY B/BA. F V OR U MAY BE FOLLOWED BY AN A OR M. REQUIRED - 'DSNAME1' AND 'DSNAME2' DEFAULTS - NUM OPERANDS 'DSNAME1'- THE DATA SET TO BE COPIED. 'DSNAME2'- THE EXISTING OR NEW DATA SET WHICH IS TO RECEIVE THE COPY. LRECL(RECORDSIZE) - RECORDSIZE SPECIFIES THE MAXIMUM LENGTH IN BYTES OF A LOGICAL RECORD FOR DSNAME2. BLOCK(BLOCKSIZE) - BLOCKSIZE SPECIFIES THE BLOCKSIZE IN BYTES THAT YOU WANT TO USE FOR 'DSNAME2'. RENUM('BEGIN INTEGER' 'INCREMENT') - THE DATA SET IS TO BE RENUMBERED. 'BEGIN INTEGER' IS THE COPY Page 47 COPY LINE NUMBER OF THE FIRST LINE. 'INCREMENT') IS THE AMOUNT EACH LINE NUMBER IS TO BE INCREASED. NUM('BEGIN COLUMN' 'FIELD LENGTH') - NUM INDICATES THE POSITION OF THE LINE NUMBER FIELD WITHIN A RECORD FOR DSNAME1. 'BEGIN COLUMN' SPECIFIES THE BEGINNING COLUMN OF THE LINE NUMBER FIELD. 'FIELD LENGTH' SPECIFIES THE LENGTH OF THE LINE NUMBER FIELD. NONUM - NONUM INDICATES THAT DATASET 'DSNAME1' HAS NO LINE NUMBER FIELD. NUM2('BEGIN INTEGER' 'INCREMENT') - NUM2 INDICATES THE POSITION OF THE LINE NUMBER FIELD WITHIN A RECORD FOR DSNAME2. 'BEGIN COLUMN' SPECIFIES THE BEGINNING COLUMN OF THE LINE NUMBER FIELD. 'FIELD LENGTH' SPECIFIES THE LENGTH OF THE LINE NUMBER FIELD. RECFM(U/V/F) - RECFM IS USED TO SPECIFY THE CHARACTERISTICS OF DATA SET RECORDS. U,V,F,OR D MAY BE SPECIFIED, INDICATING THAT RECORDS ARE UNDEFINED, VARIBLE, FIXED LENGTH OR VARIABLE ASCII. IN ADDITION U,V,F,OR D MAY BE FOLLOWED BY B,S,T,A OR M INDICATING THAT RECORDS ARE WRITTEN IN FIXED BLOCKS, STANDARD BLOCKS, USING THE TRACK OVERFLOW FEATURE OR HAVE ASCII OR MACHINE CONTROL CHARACTERS. VALID COMBINATIONS ARE AS FOLLOWS: UT,VB,VT,VBT,DB,DA, DBA,FB,FS,FT,FBS,FBT,FST,FBST. ASCII - ASCII SPECIFIES THAT TRANSLATION TO ASCII IS TO BE PERFORMED. COURSES Page 48 COURSES COMMAND NAME - COURSES FUNCTION - THE COURSES COMMAND IS USED TO PRODUCE A LIST OF CLASSES IN WHICH A STUDENT IS CURRENTLY ENROLLED. BOTH THE CLASS NAME AND CALL NUMBER ARE LISTED FOR EACH COURSE. SYNTAX - COURSES 'SSN' REQUIRED - 'SSN' OPERANDS - 'SSN'- THE SOCIAL SECURITY NUMBER OF THE STUDENT WHOSE CLASSES ARE TO BE LISTED. NOTE: ONLY AUTHORIZED USERS CAN REQUEST CLASS LISTS OF SSN'S OTHER THAN THE CURRENTLY LOGGED ON ACCOUNT. COMMAND NAME - DELETE FUNCTION - THE DELETE COMMAND IS USED TO DELETE EITHER VSAM OBJECTS OR NONVSAM DATA SETS FROM A VSAM CATALOG AND TO FREE SPACE OCCUPIED BY THE OBJECTS OR DATA SETS. ALSO THE FREE SPACE OF VSAM DATA COMPONENTS CAN BE OVERWRITTEN WITH ZEROS. THE DELETE COMMAND ALSO DELETES GDG BASES AND VSAM USERCATALOGS. SYNTAX - DELETE ('ENTRYNAME/PASSWORD' ...) CATALOG('CATNAME/PASSWORD') FILE('DNAME') PURGE | NOPURGE ERASE | NOERASE SCRATCH | NOSCRATCH DELETE Page 49 DELETE FORCE | NOFORCE CLUSTER | SPACE | USERCATALOG | ALIAS | GENERATIONDATAGROUP | PAGESPACE | NONVSAM | PATH | ALTERNATEINDEX REQUIRED - 'ENTRYNAME' SPACE (IF APPLICABLE) USERCATALOG (IF APPLICABLE) DEFAULTS - NOPURGE SCRATCH NOFORCE ABBREVIATIONS - NOTE - IN ADDITION TO NORMAL TSO SHORT FORMS, THESE ARE ACCEPTED. DELETE DEL PURGE PRG FORCE FRC NOFORCE NFRC NOPURGE NPRG NOERASE NERAS NOSCRATCH NSCR SPACE SPC USERCATALOG UCAT GENERATIONDATAGROUP GDG PAGESPACE PGSPC NONVSAM NVSAM ALTERNATEINDEX AIX OPERANDS - 'ENTRYNAME/PASSWORD' - SPECIFIES THE NAME OF ENTRY TO BE DELETED. 'ENTRYNAME' - NAME OF ENTRY TO BE DELETED. 'PASSWORD' - PASSWORD FOR PASSWORD-PROTECTED CLUSTER, PAGE SPACE, CATALOG, ALTERNATE INDEX, OR PATH. REQUIRED - 'ENTRYNAME' CATALOG('CATNAME/PASSWORD') - SPECIFIES THE NAME OF CATALOG CONTAINING THE ENTRIES TO BE DELETED. 'CATNAME' - NAME OF CATALOG CONTAINING THE ENTRIES TO BE DELETED. 'PASSWORD' - MASTER LEVEL PASSWORD OF THE CATALOG. REQUIRED - 'CATNAME' FILE('DNAME') - SPECIFIES THE LOCATION OF THE OBJECT TO BE DELETED. DELETE Page 50 DELETE 'DNAME'- NAME OF THE DD STATEMENT THAT IDENTIFIES EITHER THE VOLUME CONTAINING THE OBJECT TO BE DELETED OR THE DATA SET TO BE DELETED. FORCE - THE OBJECT IS TO BE DELETED EVEN THOUGH NOT EMPTY. THIS APPLIES ONLY TO OBJECTS THAT NORMALLY MUST BE EMPTY TO BE DELETED. NOFORCE- THE OBJECT IS NOT TO BE DELETED IF IT IS NOT EMPTY. PURGE - THE OBJECT IS TO BE DELETED REGARDLESS OF EXPIRATION DATE. NOPURGE- THE OBJECT IS NOT TO BE DELETED BEFORE EXPIRATION DATE. ERASE - THE DATA COMPONENT OF THE CLUSTER IS TO BE OVERWRITTEN WITH BINARY ZEROS. NOERASE- THE DATA COMPONENT OF THE CLUSTER IS NOT BE TO OVERWRITTEN WITH BINARY ZEROS. SCRATCH- THE NONVSAM DATA SET BEING DELETED FROM THE CATALOG IS TO BE REMOVED FROM THE VTOC OF THE VOLUME ON WHICH IT RESIDES. WHEN SCRATCH IS SPECIFIED FOR A CLUSTER, ALTERNATEINDEX, PAGESPACE, OR DATA SPACE, THE VTOCS OF THE VOLUMES INVOLVED ARE UPDATED TO REFLECT THE DELETION OF THE OBJECT. NOSCRATCH - THE NONVSAM DATA SET BEING DELETED FROM THE CATALOG IS TO REMAIN IN THE VTOC OF THE VOLUME ON WHICH IT RESIDES OR IT HAS ALREADY BEEN SCRATCHED FROM THE VTOC. WHEN NOSCRATCH IS SPECIFIED FOR A CLUSTER, PAGESPACE, ALTERNATEINDEX, OR DATA SPACE, THE VTOCS OF THE VOLUMES INVOLVED ARE NOT UPDATED. CLUSTER- THE ENTRY TO BE DELETED IS THE ENTRY FOR A CLUSTER. SPACE - THE ENTRY TO BE DELETED IS THE ENTRY FOR A DATA SPACE. REQUIRED IF APPLICABLE. DELETE Page 51 DELETE USERCATALOG - THE ENTRY TO BE DELETED IS THE ENTRY FOR A USER CATALOG. REQUIRED IF APPLICABLE. ALIAS - THE ENTRY TO BE DELETED IS THE ENTRY FOR AN ALIAS. GENERATIONDATAGROUP - THE ENTRY TO BE DELETED IS THE ENTRY FOR A GENERATION DATA GROUP. PAGESPACE - THE ENTRY TO BE DELETED IS THE ENTRY FOR A PAGE SPACE. NONVSAM- THE ENTRY TO BE DELETED IS THE ENTRY FOR A NONVSAM DATA SET. PATH - THE ENTRY TO BE DELETED IS THE ENTRY FOR A PATH. ALTERNATEINDEX - THE ENTRY TO BE DELETED IS THE ENTRY FOR AN ALTERNATE INDEX. COMMAND NAME - DOCUM FUNCTION - THE DOCUM COMMAND GIVES INFORMATION AND/OR DETAILED DOCUMENTATION ON THE FORTRAN AND PL1 MATHEMATICAL SUBROUTINE LIBRARIES. SYNTAX - DOCUM'NAME' 'OFFLINE' REQUIRED - NONE DEFAULTS - DOC (GENERAL INFORMATION) ALIASES- NONE OPERANDS - DOCUM Page 52 DOCUM 'NAME'- THE NAME OF A SINGLE ROUTINE OR A LIST OF UP TO FIFTEEN NAMES ENCLOSED IN PARANTHESIS AND SEPARATED BY COMMAS. 'OFFLINE' - IF OFFLINE IS SPECIFIED, THE INFORMATION WILL BE PRINTED ON THE SYSTEM PRINTERS OTHERWISE IT WILL BE LISTED AT YOUR TERMINAL. SUBCOMMANDS - NONE COMMAND NAME - DSN FUNCTION - THE DSNAME COMMAND IS USED TO DISPLAY AT THE USER'S TERMINAL THE USERID,TJID, & TCAM LINE NUMBER OF ANY JOBS WHICH HAVE THE REQUESTED DATA SET ALLOCATED. SYNTAX - DSNAME'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE ALIASES- DSN OPERANDS - 'DSNAME' - THE NAME OF THE DATA SET WHICH IS ALLOCATED. NOTE: THE 'DSNAME' MUST BE A DATA SET UNDER THE USER'S ACCOUNT. SUBCOMMANDS - NONE DT Page 53 DT COMMAND NAME - DT FUNCTION - THE DT COMMAND DISPLAYS THE TIME OF DAY. SYNTAX - DT ALIASES - CLOCK OPERANDS - NONE SUBCOMMANDS - NONE COMMAND NAME - DUPLICAT FUNCTION - THE DUPLICAT COMMAND IS USED TO REPRODUCE DATA SETS ON A SYSTEM OUTPUT DEVICE, USUALLY THE LINE PRINTER. SYNTAX - DUPLICAT 'DATA-SET-LIST' FORMS('FORM-CODE') COPIES('NUMBER') NUM/NONUM/SNUM CLASS('SYSOUT-CLASS') DEST('REMOTE') REQUIRED - 'DATA-SET-LIST' DEFAULTS - FORMS(STD), COPIES(1), NUM, CLASS(A) ALIAS- DUP OPERANDS - 'DATA-SET-LIST' - THE NAME OF THE DATA SET TO BE DUPLICATED, OR A LIST OF DATA SET NAMES ENCLOSED IN PARENTHESES. FORMS('FORM-CODE') - OUTPUT IS TO BE PRODUCED ON A SPECIAL FORM. 'FORM-CODE' IS A 4-DIGIT NUMBER SPECIFYING THE FORM DESIRED. DUPLICAT Page 54 DUPLICAT COPIES('NUMBER') - MULTIPLE COPIES OF THE OUTPUT ARE TO BE PRODUCED. 'NUMBER' IS THE NUMBER OF COPIES DESIRED. NUM - THE INPUT DATA SETS CONTAIN SEQUENCE NUMBERS. NONUM - THE INPUT DATA SETS DO NOT CONTAIN SEQUENCE NUMBERS. SNUM - THE INPUT DATA SETS CONTAIN SEQUENCE NUMBERS, BUT THE NUMBERS ARE NOT TO BE REPRODUCED. CLASS('SYSOUT-CLASS') - SPECIFIES THE DEVICE ON WHICH THE OUTPUT IS TO BE PRODUCED. 'SYSOUT-CLASS' IS ONE OF THE FOLLOWING: A LINE PRINTER V PLOTTER (PLOT DATA MUST BE GENERATED BY A SPECIAL SET OF SUBROUTINES) DEST('REMOTE') - OUTPUT IS TO BE SENT TO A REMOTE WORK STATION. 'REMOTE' - SPECIFIES WHICH REMOTE WORK STATION IS TO RECEIVE THE OUTPUT. COMMAND NAME - EDIT SUBCOMMANDS - ALLOCATE,ATTRIB,BOTTOM,CHANGE,CKPOINT,COPY,DELETE,DOWN,END,EXEC,FIND, FORMAT,FREE,HELP,INPUT,INSERT,LIST,MERGE,MOVE,PROFILE,RENUM,RUN,SAVE, SCAN,SEND,SCHEDULE,TABSET,TOP,UNNUM,UP,VERIFY. (TO OBTAIN EXPLANATION OF LINE INSERT/REPLACE/DELETE FUNCTION, ENTER HELP LINEDIT). FUNCTION - THE EDIT COMMAND IS USED TO CREATE OR MODIFY SEQUENTIAL DATA SETS OR MEMBERS OF PARTITIONED DATA SETS. IF A DATA SET OR MEMBER OCCUPIES LESS THAN 5 TRACKS OF DISK SPACE, THE EDITOR QED IS RECOMMENDED. SYNTAX - EDIT 'DSNAME' NEW/OLD SCAN/NOSCAN EDIT Page 55 EDIT PLIF('N1','N2',CHAR60/CHAR48)/FORTE/FORTG/FORTGI/ FORTH/COBOL/ASM/TEXT/DATA/CLIST/CNTL/BASIC/VSBASIC/ IPLI(CHAR60/CHAR48)/GOFORT(FREE/FIXED)/ PLI('N1','N2',CHAR60/CHAR48) NUM('N3','N4')/NONUM BLOCK('N5') LINE('N6') CAPS/ASIS EMODE/IMODE REQUIRED - 'DSNAME' DEFAULTS - NUM,NOSCAN ALIAS- E NOTE - IF THE FULLY QUALIFIED DATA SET NAME IS SPECIFIED, IT MUST BE ENCLOSED IN SINGLE QUOTES. IF THE DATA SET NAME IS NOT ENTERED WITHIN QUOTES, THE USERID IS ALWAYS APPENDED TO THE LEFT OF THE NAME. THE RIGHTMOST QUALIFIER OF THE NAME ENTERED MAY BE A DESCRIPTIVE QUALIFIER FOR A PARTICULAR DATA SET TYPE. NOTE - DATA SET TYPE IS ALWAYS REQUIRED IF THE DATA SET NAME IS ENTERED WITHIN QUOTES. OTHERWISE, IT IS REQUIRED ONLY IF THE RIGHTMOST QUALIFIER OF THE DATA SET NAME IS NOT A DESCRIPTIVE QUALIFIER. DATA SET TYPES ARE PLIF,FORTE, FORTG,FORTH,FORTGI,ASM,COBOL,TEXT,DATA,CLIST,CNTL,BASIC, VSBASIC,IPLI,PLI,AND GOFORT. DESCRIPTIVE QUALIFIERS ARE IDENTICAL TO DATA SET TYPES EXCEPT 'FORT' (USED FOR ALL FORTRAN TYPES,DEFAULT GOFORT) AND 'PLI' (USED FOR PLIF AND PLI, DEFAULT PLI). - THE OPERAND 'BLOCK' MAY ALSO BE SPECIFIED AS 'BLKSIZE'. THE OPERAND 'LINE' MAY ALSO BE SPECIFIED AS 'LRECL'. OPERANDS - 'DSNAME' - NAME OF THE DATA SET TO BE CREATED OR EDITED. NEW - DATA SET NAMED DID NOT EXIST BEFORE COMMAND WAS ISSUED. OLD - DATA SET ALREADY EXISTED WHEN THE EDIT COMMAND WAS ISSUED. SCAN - FOR DATA SET TYPE FORTE,FORTG,FORTGI,FORTH,IPLI,PLIF,PLI, GOFORT,OR BASIC, EACH LINE IS TO BE CHECKED FOR SYNTAX. NOSCAN - NO SYNTAX CHECKING IS TO BE PERFORMED. PLIF('N1','N2',CHAR60/CHAR48) - INPUT DATA CONSISTS OF PLI SOURCE STATEMENTS. PARAMETERS ARE OPTIONAL AND ARE USED FOR SYNTAX CHECKING ONLY. 'N1' - LEFT SOURCE MARGIN, DEFAULTS TO 2. 'N2' - RIGHT SOURCE MARGIN, DEFAULTS TO 72. EDIT Page 56 EDIT CHAR60 - SOURCE STATEMENTS USE THE 60 CHARACTER SET, THE DEFAULT. CHAR48 - SOURCE STATEMENTS USE THE 48 CHARACTER SET. FORTE - INPUT IS LEVEL E FORTRAN. FORTG - INPUT IS LEVEL G FORTRAN. FORTGI - INPUT IS LEVEL GI FORTRAN, THE ONLY LEVEL VALID FOR USE WITH THE RUN SUBCOMMAND. FORTH - INPUT IS LEVEL H FORTRAN. COBOL - DATA CONSISTS OF COBOL SOURCE STATEMENTS. ASM - DATA CONSISTS OF ASSEMBLER SOURCE STATEMENTS. TEXT - DATA IS PROSE. CHARACTER CONVERSION DEFAULT IS ASIS. DATA - DATA IS TO BE INPUT TO A PROGRAM. CLIST - DATA IS INPUT TO AN EXEC COMMAND. CNTL - DATA IS CONTROL DATA FOR A SCHEDULE COMMAND. BASIC - DATA CONSISTS OF SOURCE STATEMENTS IN THE BASIC LANGUAGE. VSBASIC- DATA CONSISTS OF SOURCE STATEMENTS IN THE VSBASIC LANGUAGE IPLI - DATA CONSISTS OF SOURCE STATEMENTS IN IPLI. GOFORT(FREE/FIXED) - DATA CONSISTS OF SOURCE STATEMENTS IN CODE AND GO FORTRAN. PARAMETERS ARE OPTIONAL, USED FOR SYNTAX CHECKING ONLY. FREE - SOURCE STATEMENTS ARE FREE FORMAT. FREE IS THE DEFAULT. FIXED- SOURCE STATEMENTS CONFORM TO STANDARD FORTRAN FORMAT. EDIT Page 57 EDIT PLI('N1','N2',CHAR60/CHAR48) - INPUT DATA CONSISTS OF PLI SOURCE STATEMENTS. PARAMETERS HAVE THE SAME MEANING AS FOR PLIF. NUM('N3','N4') - IF THE DATA SET IS NEW, RECORDS WILL CONTAIN LINE NUMBERS. IF OLD, THE RECORDS DO CONTAIN LINE NUMBERS. PARAMETERS ARE OPTIONAL AND MAY BE SPECIFIED FOR ASM DATA SETS ONLY. 'N3' - THE STARTING COLUMN OF THE LINE NUMBER. 'N3' MAY NOT BE LESS THAN 73. 'N4' - THE LENGTH OF THE LINE NUMBER. IF 'N4' IS SPECIFIED, N3+N4 CANNOT EXCEED 81 . NONUM - RECORDS WILL NOT CONTAIN LINE NUMBERS. CANNOT BE SPECIFIED FOR GOFORT, IPLI, OR BASIC DATA SETS. BLOCK('N5') OR BLKSIZE('N5') - BLOCKSIZE, FOR NEW DATA SETS ONLY. 'N5' - THE MAXIMUM BLOCK LENGTH IN BYTES. LINE('N6') OR LRECL('N6') - LOGICAL RECORD LENGTH, FOR NEW DATA SETS ONLY. 'N6' - LENGTH IN BYTES. CAPS - DATA LOWER CASE LETTERS ARE TO BE CONVERTED TO CAPITAL LETTERS, THE DEFAULT FOR ALL DATA SET TYPES EXCEPT TEXT. ASIS - INPUT LOWER CASE LETTERS ARE NOT TO BE CONVERTED TO UPPER CASE. THIS IS THE DEFAULT FOR TEXT TYPE DATA SETS. EMODE - INITIAL MODE IS TO BE EDIT MODE. THIS IS THE DEFAULT FOR EXISTING DATA SETS. IMODE - INITIAL MODE IS TO BE INPUT MODE. THIS IS THE DEFAULT FOR NEW OR EMPTY DATA SETS. ERROR Page 58 ERROR COMMAND NAME - ERROR FUNCTION - THIS IS NOT A COMMAND, BUT IS A LIST (AND EXPLANATION) OF SOME DYNAMIC ALLOCATION (DAIR) ERROR CODES. THESE ERRORS USUALLY OCCUR WHEN USING ALLOCATE, FREE, EDIT, ETC. THE ERROR MESSAGE DYNAMIC ALLOCATION ERROR CODE XXX IS USUALLY A SECOND LEVEL MESSAGE. SYNTAX - HELP ERROR OPERAND(XXX) H ERR - REQUIRED - ERROR OPERANDS OPERAND(XXX) - SPECIFIES THE DESIRED DYNAMIC ALLOCATION (DAIR) CODE LEADING ZEROS SHOULD BE OMITTED FROM ALL CODES. CATALOG, RENAME, LOCATE, OBTAIN, SCRATCH, AND DAIR NUMERIC CODES MAY ALSO BE LISTED BY PREFIXING THE TYPE TO THE ERROR CODE. FOR EXAMPLE, DAIR CODE 08 IS LISTED BY THE FOLLOWING COMMAND. H ERR OP(DAIR8) COMMAND NAME - EXEC FUNCTION - THE EXEC COMMAND INITIATES EXECUTION OF A COMMAND PROCEDURE. SYNTAX - EXEC 'DSNAME' ''PARAMETER LIST'' LIST/NOLIST PROMPT/NOPROMPT REQUIRED - DSNAME DEFAULTS - NOLIST,NOPROMPT ALIAS- EX NOTE - THE PARAMETER LIST MUST BE ENCLOSED IN APOSTROPHIES WHEN IT IS INCLUDED ON THE INVOCATION STATEMENT. MEMBERS OF THE PARAMETER LIST MUST BE SEPARATED BY THE STANDARD TSO DELIMITERS. EXEC Page 59 EXEC IF DSNAME IS NOT FULLY QUALIFIED, IT IS PREFIXED BY THE USERID AND SUFFIXED BY 'CLIST'. OPERANDS - 'DSNAME' - THE NAME OF THE DATA SET WHICH CONTAINS THE COMMAND PROCEDURE TO BE EXECUTED. ''PARAMETER LIST'' - THE LIST OF VALUES WHICH ARE TO BE SUBSTITUTED FOR THE SYMBOLIC PARAMETERS DEFINED WHEN THE COMMAND PROCEDURE WAS CREATED. LIST - THE COMMANDS AND SUBCOMMANDS IN THE COMMAND PROCEDURE ARE TO BE LISTED AT THE TERMINAL AS THEY ARE EXECUTED. NOLIST - THE COMMANDS AND SUBCOMMANDS IN THE COMMAND PROCEDURE ARE NOT TO BE LISTED AT THE TERMINAL. PROMPT - PROMPTING TO THE TERMINAL FOR INPUT IS TO BE ALLOWED DURING THE EXECUTION OF THE COMMAND PROCEDURE. ALL COMMANDS AND SUBCOMMANDS IN THE COMMAND PROCEDURE WILL BE LISTED AT THE TERMINAL AS THEY ARE EXECUTED, UNLESS THE NOLIST OPTION IS EXPLICITLY SPECIFIED. NOPROMPT - PROMPTING TO THE TERMINAL FOR INPUT IS NOT TO BE ALLOWED DURING THE EXECUTION OF THE COMMAND PROCEDURE. COMMAND NAME - FETCH FUNCTION - THE FETCH COMMAND IS USED TO DIRECT OUTPUT FROM A BATCH JOB TO A DATA SET OR TO THE TERMINAL. THE JOB MUST BE IN THE FETCH QUEUE. NOTE - TO PLACE THE OUTPUT FROM A JOB IN THE FETCH QUEUE RATHER THAN THE OUTPUT QUEUE, SPECIFY THE FETCH OPERAND OF THE SCHEDULE COMMAND, OR USE /*JOBPARM QUEUE=FETCH SYNTAX - FETCHJOB('JOB-ID') DATASET('DSNAME'/*) FETCH Page 60 FETCH PN('PNLIST')/DDNAME('DDLIST')/CLASS('SYSOUT-CLASS') SKIP('J') SEARCH(''STRING'','K'/*) COLUMN('N','M') REQUIRED - JOB('JOB-ID') DEFAULTS - DATASET(*), PN(0), SKIP(0) OPERANDS - JOB('JOB-ID') - THE BATCH JOB TO BE FETCHED. 'JOB-ID' - THE HASP JOB NUMBER OR THE JOB NAME OF THE DESIRED JOB. DATASET('DSNAME'/*) - OUTPUT IS TO BE DIRECTED TO THE SPECIFIED DESTINATION. 'DSNAME' - OUTPUT IS TO BE COPIED TO THE DATA SET IDENTIFIED BY 'DSNAME'. * - OUTPUT IS TO BE PRINTED AT THE TERMINAL. PN('PNLIST') - SELECTED SYSOUT DATA SETS ARE TO BE FETCHED. 'PNLIST' - A LIST OF SYSOUT DATA SET NUMBERS (AS DISPLAYED BY THE PN OPERAND OF THE SHOW COMMAND) TO BE FETCHED. NOTE - IF PN(0) IS SPECIFIED, ALL SYSOUT CLASS A (PRINTER) DATA SETS ARE FETCHED. DDNAME('DDLIST') - ONLY THOSE OUTPUT DATA SET WITH THE GIVEN DDNAME(S) ARE TO BE LISTED. 'DDLIST' - A LIST OF SYSOUT DDNAMES (AS DISPLAYED IN SHO JOB(XXX) PN) CLASS('SYSOUT-CLASS') - ALL OUTPUT DATA SETS FOR THE SPECIFIED SYSOUT CLASS ARE TO BE FETCH SKIP('J') - PART OF THE OUTPUT IS TO BE SKIPPED BEFORE - FETCHING BEGINS. 'J' - THE NUMBER OF LINES TO BE SKIPPED. SEARCH(''STRING'','K'/*) - A SEARCH IS TO BE MADE FOR A SPECIFIC CHARACTER STRING IN THE TEXT. ''STRING'' - THE QUOTED STRING FOR WHICH THE SEARCH IS TO BE MADE. NOTE - IF AN UPPERCASE STRING IS TO BE FOUND, THE STRING MUST BE ENTERED IN UPPERCASE. 'K' - FETCHING IS TO BEGIN AT THE K'TH LINE CONTAINING THE STRING. THIS DEFAULTS TO 1 IF THE STRING IS PRESENT. * - ONLY THOSE LINES CONTAINING THE STRING ARE TO BE FETCHED. FETCH Page 61 FETCH COLUMN('N','M') - FETCHED OUTPUT IS TO BE LIMITED TO THE BEGINNING AND ENDING COLUMNS GIVEN. THIS IS ONLY MEANINGFUL WHEN OUTPUT IS FETCHED TO THE TERMINAL ( DATASET(*) ). COMMAND NAME - FORMAT FUNCTION - THE FORMAT COMMAND PROVIDES COMPREHENSIVE FORMATTING CAPABILITIES THAT ARE APPLICABLE TO TEXT-ORIENTED OUTPUT OPERATIONS. THIS COMMAND ALLOWS THE USER TO: PLACE FORMATTED OUTPUT IN A DATA SET PRINT HEADINGS ON EACH PAGE CENTER LINES OF TEXT BETWEEN MARGINS CONTROL THE AMOUNT OF SPACE FOR ALL FOUR MARGINS JUSTIFY RIGHT AND LEFT MARGINS OF LINES OF TEXT NUMBER PAGES OF OUTPUT CONSECUTIVELY HALT PRINTING WHEN DESIRED PRINT MULTIPLE COPIES OF SELECTED PAGES CONTROL THE LINE AND PAGE LENGTH CONTROL PARAGRAPH INDENTATION SYNTAX- FORMAT 'DSLIST' 'INTEGER1' 'INTEGER2' OR PAGE('INTEGER3' 'INTEGER4') PAUSE/PAUSE1/NOPAUSE NUM/NONUM/SNUM PRINT('DSNAME'. T/PS/PC) REQUIRED - 'DSLIST' DEFAULTS - 'SNUM' 'NOPAUSE' 'T' OPERANDS- 'DSLIST' - THE INPUT DATA SETS TO BE FORMATTED. 'INTEGER1' - THE NUMBER OF THE FIRST LINE OF TEXT TO BE FORMATTED. - 'INTEGER1' MAY BE SPECIFIED ALONE IF ONLY ONE LINE - OF TEXT IS TO BE FORMATTED. 'INTEGER2' - THE NUMBER OF THE FINAL LINE OF TEXT TO BE FORMATTED. FORMAT Page 62 FORMAT PAGE('INTEGER3' 'INTEGER4') - 'INTEGER3' AND 'INTEGER4' REFER RESPECTIVELY TO THE - PAGE NUMBERS OF THE FIRST (OR ONLY) PAGE AND LAST PAGE - OF FORMATTED OUTPUT REQUESTED.'INTEGER3' MAY BE SPECIFIED - WITHOUT 'INTEGER4'IF A SINGLE PAGE IS TO BE FORMATTED. NUM - THE LINE NUMBERS ARE TO BE PRINTED WITH THE DATA. SNUM - THE LINE NUMBERS ARE NOT TO BE PRINTED. NONUM - THE DATA SET DOES NOT CONTAIN LINE NUMBERS. THE ENTIRE - RECORD WILL BE PRINTED. IF NONUM IS SPECIFIED IN - CONJUNCTION WITH 'INTEGER1'/'INTEGER2', THEN THE - LINE NUMBER(S) WILL REFER TO LINES RELATIVE TO THE - BEGINNING OF THE DATA SET. PRINT('DSNAME' 'OUTPUTTYPE') - THE OUTPUT IS TO BE PLACED IN 'DSNAME' RATHER THAN PRINTED AT THE TERMINAL. 'OUTPUTTYPE' MAY BE T. OR PC OR PS INDICATING RESPECTIVELY THAT THE OUTPUT WILL EVENTUALLY BE LISTED AT THE TERMINAL, WILL BE CONVERTED TO CAPITAL LETTERS AND WILL BE PREPARED FOR PRINTING AT A PRINTER, OR WILL NOT BE CONVERTED TO CAPITAL LETTERS BUT WILL BE PREPARED FOR PRINTING AT A PRINTER. PAUSE - FORMAT WILL WAIT FOR A CARRIAGE RETURN BEFORE PRINTING EACH PAGE OF OUTPUT. NOPAUSE- THERE ARE TO BE NO PAUSES DURING THE PRINTING. PAUSE1 - FORMAT WILL WAIT FOR A CARRIAGE RETURN BEFORE PRINTING THE FIRST PAGE OF OUTPUT. COMMAND NAME - FORT FUNCTION- THE FORT COMMAND INVOKES EITHER THE G1 LEVEL OR THE H EXTENDED LEVEL FORTRAN COMPILER. FORT Page 63 FORT SYNTAX - FORT'SOURCE DSNAME' LEVEL(G/H) LIBRARY('LOAD LIBRARY DSNAME') EBCDIC / BCD ID / NOID LINECNT('INTEGER') LIST / NOLIST LOAD('LOAD DSNAME') / NOLOAD MAP / NOMAP NAME('PROGRAM NAME') PRINT('PRINT DSNAME') / NOPRINT SOURCE / NOSOURCE SYSPRINT('CLASSNAME') TERMINAL / NOTERMINAL -- THE FOLLOWING APPLY ONLY TO FORTRAN H EXTENDED -- ALC / NOALC ANSF / NOANSF AUTODBL('VALUE') DUMP / NODUMP FLAG(I / E / S) FORMAT / NOFORMAT OPTIMIZE(0/1/2) / NOOPTIMIZE SIZE(MAX / 'REGION SIZE') XL XREF / NOXREF REQUIRED - 'SOURCE DSNAME' - 'LOAD LIBRARY DSNAME' IF LIBRARY KEYWORD IS SPECIFIED - - 'LOAD DSNAME' AND 'PRINT DSNAME'/* ARE OPTIONAL WHEN - LOAD OR PRINT ARE SPECIFIED RESPECTIVELY DEFAULTS - LEVEL(G) LOAD TERM - ALL OTHER KEYWORDS DEFAULT TO COMPILER DEFAULTS - NOTE - NOPRINT CAUSES NOSOURCE,NOLIST,NOMAP TO BE DEFAULTED REGARDLESS OF WHAT IS SPECIFIED IN THE COMMAND LINE. - IF PRINT AND NOPRINT ARE BOTH OMITTED THEN SPECIFYING ONE OR MORE OF SOURCE,LIST, OR MAP CAUSES PRINT TO BE DEFAULTED. - WHEN SYSPRINT IS SPECIFIED, PRINT/NOPRINT IS IGNORED. - PRINT(*) CAUSES NOTERM TO BE DEFAULTED REGARDLESS OF WHAT IS SPECIFIED IN THE COMMAND LINE. OPERANDS - EBCDIC - SPECIFIES THAT THE SOURCE MODULE IS WRITTEN IN EXTENDED BINARY CODED DECIMAL INTERCHANGE CODE. FORT Page 64 FORT BCD - SPECIFIES THAT THE SOURCE MODULE IS WRITTEN IN BINARY CODED DECIMAL. ID - SPECIFIES THAT INTERNAL STATEMENT NUMBER(ISN) IDENTIFIERS ARE TO BE GENERATED BY THE COMPILER. NOID - SPECIFIES THAT NO INTERNAL STATEMENT NUMBER(ISN) IDENTIFIERS ARE TO BE GENERATED. LINECNT('INTEGER') - SPECIFIES A USER ASSIGNED VALUE TO THE NUMBER OF LINES PER PAGE TO BE WRITTEN ON THE PRINT DATA SET. 'INTEGER' - A ONE OR TWO DIGIT NUMBER IN THE RANGE FROM 1 TO 99 THAT INDICATES THE NUMBER OF LINES PER PAGE TO BE WRITTEN ON THE PRINT DATA SET. LIST - SPECIFIES THAT AN OBJECT MODULE LISTING IS TO BE WRITTEN - ON THE PRINT DATA SET. NOLIST - SPECIFIES THAT AN OBJECT MODULE LISTING IS NOT TO BE GENERATED. LOAD('LOAD DSNAME') - SPECIFIES THAT AN OBJECT MODULE IS TO BE GENERATED. 'LOAD DSNAME' - THE NAME OF THE DATA SET ON WHICH THE OBJECT MODULE IS TO - BE WRITTEN. IF NOT SPECIFIED A DEFAULT NAME IS CONSTRUCTED - FROM THE 'SOURCE DSNAME' AND THE QUALIFIER '.OBJ'. NOLOAD - SPECIFIES THAT NO OBJECT MODULE IS TO BE GENERATED. MAP - SPECIFIES THAT A MAP TABLE SHOWING OBJECT MODULE ADDRESSES - ASSIGNED TO CERTAIN SYMBOLIC NAMES IS TO BE WRITTEN ON THE - PRINT DATA SET. NOMAP - SPECIFIES THAT A MAP TABLE IS NOT TO BE GENERATED. NAME('PROGRAM NAME') - SPECIFIES THAT THE USER SUPPLIED NAME IS TO BE GIVEN TO THE FORT Page 65 FORT MAIN PROGRAM COMPILED BY FORTRAN. 'PROGRAM NAME' - THIS IS A 1 TO 6 ALPHANUMERIC NAME,BEGINING WITH AN ALPHABETIC CHARACTER THAT IS ASSIGNED BY FORTRAN TO - THE MAIN PROGRAM COMPILED. PRINT('PRINT DSNAME'/*) - SPECIFIES THAT COMPILER OUTPUT IS TO BE WRITTEN TO A DATA SET. 'PRINT DSNAME'/* - THE NAME OF THE DATA SET ON WHICH THE PRINT OUTPUT IS TO - BE WRITTEN. IF NOT SPECIFIED A DEFAULT NAME IS CONSTRUCTED FROM THE 'SOURCE DSNAME' AND THE QUALIFIER '.LIST'. - PRINT(*) ALLOCATES TO THE TERMINAL FOR PRINT OUTPUT. NOPRINT- SPECIFIES THAT NO PRINT DATA SET IS TO BE GENERATED. SOURCE - SPECIFIES THAT A LISTING OF THE FORTRAN SOURCE STATEMENTS - IS TO BE WRITTEN ON THE PRINT DATA SET. NOSOURCE - SPECIFIES THAT A LISTING OF THE FORTRAN SOURCE STATEMENTS - IS NOT TO BE GENERATED. SYSPRINT('CLASSNAME') - SPECIFIES THE LISTING OF THE SYSPRINT FILE IS TO BE PUT - IN A SYSOUT CLASS AND QUEUED FOR PRINTING IMMEDIATELY. 'CLASSNAME' - IS OPTIONAL AND IS THE NAME OF THE SYSOUT CLASS - WHICH IS TO CONTAIN THE LISTING OF THE SYSPRINT FILE. IF - IT IS OMITTED CLASS 'A' IS ASSUMED TERM - SPECIFIES THAT DIAGNOSTIC OUTPUT,COMPILER STATISTICS,AND - A PROGRESS MESSAGE IS TO BE WRITTEN TO THE TERMINAL. - FOR MORE COMPHREHENSIVE OUTPUT TO BE WRITTEN TO THE - TERMINAL PRINT(*) SHOULD BE USED TOGETHER WITH ONE OR - MORE OF THE SOURCE,LIST,OR MAP KEYWORDS. NOTERM- SPECIFIES THAT THE TERM DATA SET IS NOT TO BE GENERATED. ALC - SPECIFIES WHETHER DATA ITEMS ARE TO BE ALIGNED. THIS IS OFTEN USED WITH THE AUTODBL OPTION TO RESTORE PROPER STORAGE BOUNDARIES WHEN A CONVERSION IS PERFORMED. FORT Page 66 FORT NOALC- DATA ITEMS ARE NOT TO BE ALIGNED ANSF - SPECIIFES THAT THE COMPILER IS TO RECOGNIZE ONLY THOSE LIBRARY AND BUILT-IN FUNCTIONS SPECIFIED BY ANSI. NOANSF - SPECIFIES THAT THE COMPILER IS TO RECOGNIZE THE ENTIRE RANGE OF FUNCTIONS SPECIFIED BY IBM. AUTODBL('VALUE') - SPECIFIES THAT THE AUTOMATIC PRECISION INCREASE FACILITY IS TO BE USED TO CONVERT DATA ITEMS TO HIGHER PRECISION. MORE REGARDING AUTODBL AND 'VALUE' CAN BE FOUND IN THE IBM MANUAL 'IBM OS FORTRAN IV(H EXTENDED) COMPILER PROGRAMMERS GUIDE' THE SECTION, 'AUTOMATIC PRECISION INCREASE FACILITY' DUMP - SPECIFIES THAT A DUMP IS TO BE WRITTEN TO A DDNAME SYSUDUMP OR SYSABEND IN THE EVENT OF A COMPILER ABEND. TO USE THIS OPTION, THE USER MUST ALLOCATE THE DDNAME SYSUDUMP, BEFORE ISSUING THE FORT COMMAND. NODUMP - SPECIFIES THAT NO DUMP IS TO BE TAKEN IN THE EVENT OF A COMPILER ABEND. FLAG(I/E/S) - SPECIFIES THE LEVEL OF DIAGNOSTIC MESSAGES TO BE PRINTED BY THE COMPILER. FLAG(I) - THIS INDICATES THAT WARNING(CODE 4), ERROR(CODE 8), AND SEVERE(CODE 12) ERROR MESSAGES ARE TO BE PRINTED. FLAG(E) - THIS INDICATES THAT ONLY ERROR AND SEVERE ERROR MESSAGES ARE TO BE PRINTED. FLAG(S) - INDICATES THAT ONLY SEVERE ERROR MESSAGES ARE TO BE PRINTED FORMAT - SPECIFIES THAT A STRUCTURED SOURCE MODULE LISTING IS TO BE WRITEN ON THE PRINT DATASET. THIS OPTION IS ONLY EFFECTIVE WHEN OPTIMIZE(2) IS IN EFFECT. NOFORMAT - SPECIFIES THAT NO STRUCTURED LISTING IS REQUESTED. FORT Page 67 FORT OPTIMIZE(0/1/2) - SPECIFIES THE TYPE OF OPTIMIZATION REQUIRED 0 - IS EQUIVALENT TO NOOPTIMIZE 1 - SPECIFIES SOME OPTIMIZATION OF THE COMPILED CODE. 2 - SPECIFIES THAT THE COMPILER IS TO OPTIMIZE THE MACHINE - INSTRUCTIONS GENERATED FOR MINIMUM EXECUTION TIME NOOPTIMIZE - NO OPTIMIZATION IS TO BE PERFORMED. SIZE(MAX / 'REGION SIZE') - SPECIFIES THE AMOUNT OF STORAGE TO BE ALLOCATED TO THE COMPILER. SIZE(MAX) - THE COMPILER USES ALL AVAILABLE STORAGE, SAVE ABOUT 3K BYTES WHICH ARE RESERVED FOR OPERATING SYSTEM ROUTINES. 'REGION SIZE' - A NUMBER FROM 160K TO 9999K REPRESENTING THE NUMBER OF K BYTES TO ALLOCATE TO THE COMPILER. XL - THE XL PARM IS TO BE PASSED TO THE COMPILER. XREF - A CROSS REFERENCE LISTING OF VARIABLES AND LABELS IS TO BE PRODUCED. NOXREF - NO CROSS REFERENCE LISTING IS TO BE PRODUCED. COMMAND NAME - FREE FUNCTION - THE FREE COMMAND DYNAMICALLY UNALLOCATES A DATA SET AND/OR DELETES AN ATTRIBUTE LIST. IT MAY ALSO BE USED TO CHANGE OUTPUT CLASS OF SYSOUT DATA SETS FOR IMMEDIATE AVAILABILITY FOR PROCESSING BY AN OUTPUT WRITER IN ADDITION TO UNALLOCATING THEM OR TO CHANGE THE SYSOUT HOLD QUEUE SPECIFICATION. A DATASET DISPOSITION MAY BE ENTERED TO OVERRIDE THE DISPOSITION SPECIFIED WHEN THE DATASET WAS ALLOCATED. FREE Page 68 FREE SYNTAX - FREE DATASET('DSLIST') FILE('DDLIST') ATTRLIST('ALNLIST') DEST('STATIONID') HOLD/NOHOLD KEEP/DELETE/CATALOG/UNCATALOG/SYSOUT('CLASS') ALL REQUIRED-EITHER DSNAME OR DDNAME OF ANY DATA SETS TO BE UNALLOCATED AND/OR ATTR-LIST-NAME OF ANY ATTRIBUTE LISTS TO BE DELETED, OR ALL KEYWORD. NOTE- IF NO OVERRIDING DISPOSITION IS SPECIFIED, DATA SETS ARE DISPOSED OF IN MANNER SPECIFIED WHEN ALLOCATED. - THE OPERAND 'DATASET' MAY ALSO BE SPECIFIED AS 'DSNAME'. THE OPERAND 'FILE' MAY ALSO BE SPECIFIED AS 'DDNAME'. DEFAULTS-NONE OPERANDS - DATASET('DSLIST') OR DSNAME('DSLIST') - DSLIST IS LIST OF DSNAMES OF DATA SETS TO BE UNALLOCATED. FILE('DDLIST') OR DDNAME('DDLIST') - DDLIST IS LIST OF DDNAMES ASSOCIATED WITH DATA SETS TO BE UNALLOCATED. SYSOUT('CLASS') - THE SYSOUT DATA SETS SPECIFIED IN 'DSLIST' AND/OR 'DDLIST' ARE ASSIGNED THIS CLASS FOR PROCESSING BY AN OUTPUT WRITER UPON UNALLOCATION. ATTRLIST('ALNLIST') - ALNLIST IS LIST OF ATTR-LIST-NAMES OF ATTRIBUTE LISTS TO BE DELETED. DEST('STATIONID') - SPECIFIES A REMOTE WORK STATION TO WHICH SYSOUT DATA SETS WILL BE DIRECTED UPON UNALLOCATION. THE STATIONID IS THE ONE TO EIGHT CHARACTER NAME OF THE REMOTE WORK STATION RECEIVING THE SYSOUT DATA SET. HOLD - THE SYSOUT DATASET IS TO BE PLACED ON THE HOLD QUEUE. NOHOLD - THE SYSOUT DATASET IS NOT TO BE PLACED ON THE HOLD QUEUE. FREE Page 69 FREE KEEP - DATASET DISPOSITION OS KEEP. IGNORED FOR SYSOUT. DELETE - DATASET DISPOSITION IS DELETE. CATALOG - DATASET IS TO BE CATALOGED. IGNORED FOR SYSOUT. UNCATALOG - DATASET IS TO BE UNCATALOGED. IGNORED FOR SYSOUT. ALL - ALL DYNAMICALLY ALLOCATED DATASETS, FILES AND ATTRIBUTE LISTS ARE TO BE UNALLOCATED. COMMAND NAME - FREEALL FUNCTION - THE FREEALL COMMAND IS USED TO FREE ALL DATA SETS AND ATTRIBUTE LISTS THAT ARE ALLOCATED DYNAMICALLY. SYNTAX - FREEALLSCRATCH/NOSCRATCH TERM/NOTERM DUMMY/NODUMMY SYSOUT/NOSYSOUT LIST/NOLIST SELECT/NOSELECT REQUIRED - NONE DEFAULTS - SCRATCH,TERM,DUMMY,SYSOUT,NOLIST,NOSELECT ALIASES- FA OPERANDS - SCRATCH - TEMPORARY DATA SETS ARE TO BE FREED AND DELETED. NOSCRATCH - TEMPORARY DATA SETS ARE TO BE NEITHER FREED NOR DELETED. TERM - TERMINAL (DA(*)) DATA SETS ARE TO BE FREED. NOTERM - TERMINAL (DA(*)) DATA SETS ARE NOT TO BE FREED. FREEALL Page 70 FREEALL DUMMY- DUMMY (DA('NULLFILE')) DATA SETS AND ATTRIBUTE LISTS ARE TO BE FREED. NODUMMY - DUMMY (DA('NULLFILE')) DATA SETS AND ATTRIBUTE LISTS ARE NOT TO BE FREED. SYSOUT - SYSOUT DATA SETS ARE TO BE FREED. NOSYSOUT - SYSOUT DATA SETS ARE NOT TO BE FREED. LIST - A MESSAGE IS TO BE PRINTED UPON COMPLETION OF EACH OPERATION. NOLIST - NO MESSAGES ARE TO BE PRINTED. SELECT - INDICATES THE USER WISHES TO SELECTIVELY FREE THE FILES ALLOCATED. THE SYSTEM WILL PROMPT WITH THE DDNAME OF A FILE AND PAUSE FOR A USER REPLY. IF THE USER REPLIES 'N' THE FILE WILL NOT BE FREED. IF THE USER REPLIES '?' THE DSNAME ASSOCIATED WITH THE FILE WILL BE DISPLAYED AND THE QUESTION REASKED. ANY OTHER RESPONSE (INCLUDING CARRIAGE RETURN) WILL CAUSE THE FILE TO BE FREED. SELECT CAN BE USED IN CONJUNCTION WITH ANY OF THE OTHER OPERANDS. NOSELECT - THE FILES ARE NOT TO BE SELECTIVELY FREED. COMMAND NAME - HELP FUNCTION - THE HELP COMMAND PROVIDES FUNCTION, SYNTAX, AND OPERAND INFORMATION ON COMMANDS. MESSAGE IDENTIFIER INFORMATION IS SUPPLIED WHEN AVAILABLE. SYNTAX - HELP 'COMMAND NAME' FUNCTION SYNTAX OPERANDS('KEYWORD LIST') ALL / MSGID('MESSAGE IDENTIFIER LIST') HELP Page 71 HELP REQUIRED - NONE DEFAULTS - ALL IF FUNCTION, SYNTAX, OPERANDS AND MSGID NOT SPECIFIED. ALIAS- H NOTE - MSGID CAN NOT BE SPECIFIED WITH THE FUNCTION, SYNTAX, OPERANDS, OR ALL KEYWORDS. NOTE - IF HELP IS ENTERED WITHOUT ANY OPERANDS A LIST OF AVAILABLE COMMANDS WITH A SHORT DESCRIPTION OF EACH WILL BE DISPLAYED. NOTE - 'KEYWORD LIST' IS OPTIONAL WHEN OPERANDS IS USED. SYNTAX INTERPRETATION - 1. USER SUPPLIED VALUES ARE IN APOSTROPHES. TWO SETS OF APOSTROPHES MEANS THE VALUE SHOULD BE SUPPLIED WITHIN A SET OF APOSTROPHES. 2. WORDS WITHOUT APOSTROPHES ARE TO BE ENTERED AS SHOWN. 3. COMMAS, PERIODS, PARENTHESES, AND ASTERISKS ARE TO BE ENTERED AS SHOWN. 4. EXCULSIVE CHOICES ARE INDICATED BY SLASH (/). 5. MUTUALLY EXCLUSIVE FORMATS ARE SEPARATED BY 'OR'. OPERANDS - 'COMMAND NAME' - NAME OF THE COMMAND TO BE EXPLAINED. FUNCTION - FUNCTION IS TO BE DISPLAYED. SYNTAX - FORMAT IS TO BE DISPLAYED. OPERANDS('KEYWORD LIST') - OPERAND DESCRIPTION IS TO BE DISPLAYED. IF 'KEYWORD LIST' IS PRESENT, ONLY THOSE KEYWORD DESCRIPTIONS ARE TO BE DISPLAYED. 'KEYWORD LIST' - KEYWORDS SEPARATED BY COMMAS, BLANKS, OR TABS. ALL - FUNCTION, SYNTAX, AND OPERAND DESCRIPTIONS ARE TO BE DISPLAYED. MSGID('MESSAGE IDENTIFIER LIST') - THE MESSAGE(S) ASSOCIATED WITH THE GIVEN MESSAGE IDENTIFIERS WILL BE DISPLAYED. 'MESSAGE IDENTIFIER LIST' - A MESSAGE IDENTIFIER OR A LIST OF MESSAGE IDENTIFIERS SEPARATED BY COMMAS, BLANKS, OR TABS. HELP Page 72 HELP SUBCOMMAND HELP (MAY BE ABBREVIATED H) FUNCTION - THE HELP SUBCOMMAND PROVIDES FUNCTION, SYNTAX, AND OPERAND INFORMATION ON THE CURRENTLY PROCESSING COMMAND AND ITS SUBCOMMANDS. MESSAGE IDENTIFIER INFORMATION IS SUPPLIED WHEN AVAILABLE. SYNTAX - HELP 'SUBCOMMAND NAME'/'CURRENT COMMAND NAME' FUNCTION SYNTAX OPERANDS('KEYWORD LIST') ALL / MSGID('MESSAGE IDENTIFIER LIST') REQUIRED - NONE DEFAULTS - ALL IF FUNCTION, SYNTAX, OPERANDS AND MSGID NOT SPECIFIED. ALIAS- H NOTE - IF HELP IS ENTERED WITHOUT ANY OPERANDS A LIST OF SUBCOMMANDS OF THE CURRENT COMMAND WILL BE DISPLAYED. NOTE - 'KEYWORD LIST' IS OPTIONAL WHEN OPERANDS IS USED. NOTE - MSGID CAN NOT BE SPECIFIED WITH THE FUNCTION, SYNTAX, OPERANDS, OR ALL KEYWORDS. OPERANDS - 'SUBCOMMAND NAME' - NAME OF THE SUBCOMMAND OF THE CURRENT COMMAND TO BE EXPLAINED. 'CURRENT COMMAND NAME' - ENTERED IF THE CURRENTLY PROCESSING COMMAND IS TO BE EXPLAINED. FUNCTION - FUNCTION IS TO BE DISPLAYED SYNTAX - FORMAT IS TO BE DISPLAYED. OPERANDS('KEYWORD LIST') - OPERAND DESCRIPTION IS TO BE DISPLAYED. IF 'KEYWORD LIST' IS PRESENT, ONLY THOSE KEYWORD DESCRIPTIONS ARE TO BE DISPLAYED. 'KEYWORD LIST' - KEYWORDS SEPARATED BY COMMAS, BLANKS, OR TABS. ALL - FUNCTION, SYNTAX, AND OPERAND DESCRIPTIONS ARE TO BE DISPLAYED. HELP Page 73 HELP MSGID('MESSAGE IDENTIFIER LIST') - THE MESSAGE(S) ASSOCIATED WITH THE GIVEN MESSAGE IDENTIFIER(S) WILL BE DISPLAYED. 'MESSAGE IDENTIFIER LIST' - A MESSAGE IDENTIFIER OR A LIST OF MESSAGE IDENTIFIERS SEPARATED BY COMMAS, BLANKS, OR TABS. COMMAND NAME - INFORM 1 For information on the INFORM command, enter INFORM with no operands. COMMAND NAME - LABELS FUNCTION - THE LABELS COMMAND PRODUCES MAILING LABELS FROM AN APPROPRIATELY FORMATTED INPUT DATASET. MAILING LABELS MAY NOT BE PRINTED EXCEPT AFTER ARRANGEMENTS HAVE BEEN MADE WITH THE OPERATIONS MANAGER SYNTAX- LABELS DATASET COPIES(NUMBER) FORMS(FORMSCODE) CODES(CODE FIELDDS SEPERATED BY SLASHES) REQUIRED - DATASET DEFAULT- FORMS(3312) COPIES(1) CODES() OPERANDS - LABELS Page 74 LABELS DATASET - DSNAME OF THE INPUT DATASET FORMS - THE FORMS CODE TO BE USED FOR PRINTING THE LABELS LABELS ARE AVAILABLE ONLY AFTER ARRANGEMENTS HAVE BEEN MADE WITH THE OPERATIONS MANAGER COPIES- NUMBER OF COPIES DESIRED CODES - THE FIRST LINE OF EACH LABEL IS NOT PRINTED BUT USED TO ALLOW SELECTIVE PRINTING OF LABELS. IF NO CODE IS USED ALL LABELS ARE PRINTED. IF CODES ARE SUPPLIED THEN THOSE LABELS WHICH HAVE ONE OF THE CODE VALUES AS A FIRST LINE WILL BE PRINTED. THE FIRST LINE OF THE LABELS IS NEVER PRINTED. EXAMPLE: LABELS .... CODES(1/2/3) WILL PRINT ALL LABELS WHICH HAVE FIRST LINES OF 1 2 OR 3. THE LINE WHICH CONTAINS THE CODE WILL NOT BE PRINTED COMMAND NAME - LC Function - The LC command lists entry names (data set names) from the catalog.The output is produced in several columns, to allow more information to be held on the screen of a CRT terminal, and to use less paper on a hard copy terminal (compared with the LISTCAT command). Syntax - LC LEVEL('index-level')/LIKE('string') Required - none Defaults - LEVEL('current prefix') Note - In addition to normal TSO short forms, L may be used as an abbreviation of LEVEL. Operands - LEVEL('index-level') - specifies the catalog index level at which the search for data set names is to begin. Unlike the LISTCAT command, your current prefix is automatically LC Page 75 LC inserted in front of the level you supply if the level is not enclosed in apostrophes. LIKE('string') - specifies that data set names which begin with the given string are to be listed. COMMAND NAME - LIBCALL FUNCTION - THE LIBCALL COMMAND IS USED TO EXECUTE A PROGRAM THAT RESIDES IN THE SYSTEM LIBRARY, OR A PROGRAM WHICH REQUIRES A TASKLIB. SYNTAX - LIBCALL 'PROGNAME' ''PARAMETERS'' LIBRARY('LIBLIST') REQUIRED - 'PROGNAME' DEFAULTS - NONE OPERANDS - 'PROGNAME' - THE NAME OF THE PROGRAM TO BE EXECUTED. IT MUST RESIDE IN THE SYSTEM LIBRARY, OR BE IN THE LIBRARY SPECIFIED BY THE LIBRARY OPERAND. ''PARAMETERS'' - A QUOTED STRING OF PARAMETERS TO BE PASSED TO THE PROGRAM. LIBRARY('LIBLIST') - THE LIBRARY, OR LIST OF LIBRARIES TO BE USED AS A TASKLIB TO RESOLVE REFERENCES. 'LIBLIST' - LIST OF LIBRARY NAMES TO BE USED. LINDO Page 76 LINDO COMMAND NAME - LINDO FUNCTION - THE LINDO COMMAND CALLS THE LINDO PROGRAM, AN INTERACTIVE LINEAR PROGRAMMING PACKAGE. FURTHER INFORMATION IS AVAILABLE FROM THE QUANTATIVE METHODS DEPARTMENT. SYNTAX - LINDO OPERANDS - NONE COMMAND NAME - LINK FUNCTION - THE LINK COMMAND IS USED TO INVOKE THE LINKAGE EDITOR WHICH WILL RESOLVE REFERENCES AND PRODUCE A LOAD MODULE. SYNTAX - LINK 'DSLIST' LOAD('DSNAME') PRINT('DSNAME')/NOPRINT LIB('KWDSLIST') COBLIB PLILIB FORTLIB PLIBASE PLICMIX MAP/NOMAP XREF/NOXREF LIST/NOLIST LET/NOLET XCAL/NOXCAL NCAL/NONCAL SCTR/NOSCTR OVLY/NOOVLY RENT/NORENT REUS/NOREUS REFR/NOREFR NE/NONE OL/NOOL DC/NODC TEST/NOTEST HIAR/NOHIAR TERM/NOTERM DCBS('INTEGER') SIZE('INTEGER1,INTEGER2') ALIGN2/NOALIGN2 AC(ACCESS CODE) REQUIRED - 'DSLIST' DEFAULTS - NOPRINT NOMAP NOXREF NOLIST NOLET NOXCAL NONCAL NOSCTR NOOVLY NORENT NOREUS NOREFR NONE NOOL NODC NOTEST NOHIAR TERM NOALIGN2 OPERANDS - 'DSLIST' - LIST OF INPUT DATA SET NAMES. AN '*' IN THE LIST WILL ALLOW LINKAGE EDITOR CONTROL STATEMENTS TO BE ENTERED FROM THE TERMINAL. LINK Page 77 LINK LOAD('DSNAME') - SPECIFIES NAME OF DATA SET INTO WHICH OUTPUT LOAD MODULE WILL BE WRITTEN. PRINT('DSNAME') - LINKAGE EDITOR LISTINGS WILL BE PRODUCED. 'DSNAME' - OPTIONAL PARAMETER TO SPECIFY A DATA SET TO BE USED FOR THE LISTINGS. TO DISPLAY LISTINGS AT THE TERMINAL, CODE '*' FOR 'DSNAME'. NOPRINT- NO LIKAGE EDITOR LISTINGS WILL BE PRODUCED. LIB('KWDSLIST') - LIBRARIES WILL BE USED TO RESOLVE EXTERNAL REFERENCES. 'KWDSLIST' - LIST OF THE LIBRARY NAMES TO BE USED. COBLIB - SYS1.COBLIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. PLILIB - SYS1.PL1LIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. FORTLIB- SYS1.FORTLIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. PLIBASE- SYS1.PLIBASE WILL BE USED TO RESOLVE EXTERNAL REFERENCES. PLICMIX- SYS1.PLICMIX WILL BE USED TO RESOLVE EXTERNAL REFERENCES. MAP - A LIST OF EXTERNAL NAMES AND THEIR LOCATIONS WILL BE WRITTEN ON THE PRINT DATA SET. NOMAP - A LIST OF EXTERNAL NAMES AND THEIR LOCATIONS WILL NOT BE PRODUCED. XREF - A LIST OF EXTERNAL NAMES AND THEIR LOCATIONS PLUS A CROSS REFERENCE LIST WILL BE WRITTEN ON THE PRINT DATA SET. NOXREF - A CROSS REFERENCE LIST WILL NOT BE PRODUCED. LINK Page 78 LINK LIST - A LIST OF LINKAGE EDITOR CONTROL STATEMENTS WILL BE WRITTEN ON THE PRINT DATA SET. NOLIST - A LIST OF LINKAGE EDITOR CONTROL STATEMENTS WILL NOT BE PRODUCED. LET - LOAD MODULE WILL BE MARKED EXECUTABLE EVEN IF A SEVERITY 2 ERROR OCCURRED. NOLET - LOAD MODULE WILL BE MARKED NOT EXECUTABLE IF A SEVERITY 2 ERROR OCCURRED. XCAL - LOAD MODULE WILL BE MARKED EXECUTABLE IF VALID EXCLUSIVE CALLS ARE ENCOUNTERED. NOXCAL - LOAD MODULE WILL BE MARKED NOT EXECUTABLE IF EXCLUSIVE CALLS ARE ENCOUNTERED. NCAL - THE LINKAGE EDITOR WILL NOT RESOLVE ANY UNRESOLVED EXTERNAL REFERENCES. NONCAL - THE LINKAGE EDITOR WILL TRY TO RESOLVE ANY UNRESOLVED EXTERNAL REFERENCES. SCTR - LOAD MODULE WILL BE MARKED FOR SCATTER LOADING. NOSCTR - LOAD MODULE WILL NOT BE MARKED FOR SCATTER LOADING. OVLY - LOAD MODULE IS TO BE AN OVERLAY STRUCTURE. NOOVLY - LOAD MODULE IS NOT TO BE AN OVERLAY STRUCTURE. RENT - LOAD MODULE IS TO BE MARKED REENTRABLE. NORENT - LOAD MODULE IS NOT TO BE MARKED REENTRABLE. REUS - LOAD MODULE IS TO BE MARKED REUSABLE. LINK Page 79 LINK NOREUS - LOAD MODULE IS NOT TO BE MARKED REUSABLE. REFR - LOAD MODULE IS TO BE MARKED REFRESHABLE. NOREFR - LOAD MODULE IS NOT TO BE MARKED REFRESHABLE. NE - LOAD MODULE MAY NEVER BE REPROCESSED BY THE LINKAGE EDITOR OR LOADER. NONE - LOAD MODULE MAY BE REPROCESSED BY THE LINKAGE EDITOR OR LOADER. OL - LOAD MODULE MAY BE LOADED INTO CORE ONLY BY LOAD MACRO. NOOL - LOAD MODULE LOADING NOT RESTRICTED TO LOAD MACRO. DC - LOAD MODULE MAY BE REPROCESSED BY E-LEVEL LINKAGE EDITOR. NODC - LOAD MODULE MAY NOT BE REPROCESSED BY THE E-LEVEL LINKAGE EDITOR. TEST - SYMBOL TABLES WILL BE TRANSFERRED TO LOAD MODULE. NOTEST - SYMBOL TABLES WILL NOT BE TRANSFERRED TO LOAD MODULE. HIAR - HIERARCHY ASSIGNMENTS FOR CSECTS MAY BE MADE. NOHIAR - NO HIERARCHY ASSIGNMENTS FOR CSECTS WILL BE MADE. TERM - LINKAGE EDITOR ERROR MESSAGES WILL BE DISPLAYED AT THE TERMINAL. NOTERM - LINKAGE EDITOR ERROR MESSAGES WILL NOT BE DISPLAYED AT THE TERMINAL. LINK Page 80 LINK DCBS('INTEGER') - SPECIFIES BLOCKSIZE FOR LOAD MODULE DATA SET. SIZE('INTEGER1,INTEGER2') - SPECIFIES AMOUNT OF STORAGE TO BE USED BY LINKAGE EDITOR. 'INTEGER1' - TOTAL NUMBER OF BYTES USED BY LINKAGE EDITOR. 'INTEGER2' - NUMBER OF BYTES TO BE USED FOR LOAD MODULE BUFFERS. ALIGN2 - ALIGNS LOAD MODULE ON A 2K PAGE BOUNDARY. AC('ACCESS CODE') - UP TO 3 DECIMAL DIGITS FROM 0 TO 255 DEFINING THE ACCESS CODE ASSIGNED TO THE LOAD MODULE. COMMAND NAME - LISP FUNCTION - THE LISP COMMAND IS USED TO INVOKE THE LISP PROCESSOR. SYNTAX - LISP RESTORE('RESTORE-DSNAME')/NORESTORE R('STORAGE-LENGTH') F('PERCENTAGE')/B('PERCENTAGE') REQUIRED - NONE DEFAULTS - R(8K),F(100) NOTE - IF NEITHER 'RESTORE' NOR 'NORESTORE' IS SPECIFIED RESTORE FROM A STANDARD RESTORE FILE IS DEFAULTED. OPERANDS - RESTORE - LISP IS TO BE RESTORED FROM A LISP CHECKPOINT FILE. 'RESTORE-DSNAME' - THE NAME OF THE DATASET FROM WHICH LISP IS TO BE RESTORED. NORESTORE - LISP IS NOT TO BE RESTORED. LISP Page 81 LISP R 'STORAGE-LENGTH' - THE LENGTH OF STORAGE TO BE RESERVED FOR OPERATING SYSTEM USE, INPUT-OUTPUT BUFFERS ETC. IT MAY BE SPECIFIED EITHER AS A NUMBER, OR A NUMBER FOLLOWED BY THE LETTER K TO INDICATE MULTIPLES OF 1024 BYTES. B 'PERCENTAGE' - THE PERCENTAGE OF THE STORAGE ACQUIRED THAT IS TO BE USED FOR BINARY PROGRAM SPACE. F 'PERCENTAGE' - THE PERCENTAGE OF THE STORAGE ACQUIRED THAT IS TO BE USED FOR FREE CELL STORAGE. COMMAND NAME - LIST FUNCTION - THE LIST COMMAND IS USED TO PRINT OUT PART OR ALL OF A SEQUENTIAL DATA SET OR MEMBER OF A PARTITIONED DATA SET. SYNTAX- LIST 'DSLIST' 'INTEGER1' 'INTEGER2' NUM('BEGIN INTEGER' 'LENGTH')/ SNUM('BEGIN COLUMN' 'LENGTH')/NONUM COL('BEGIN COLUMN':'END COLUMN') REQUIRED - DSLIST DEFAULTS - NUM OPERANDS - 'DSLIST' - THE SEQUENTIAL DATA SET(S) OR MEMBER(S) OF A PARTITIONED DATA SET(S) TO BE LISTED. 'INTEGER1' - THE LINE NUMBER OF THE FIRST RECORD TO BE PRINTED. - 'INTEGER1' MAY BE SPECIFIED ALONE OR WITH 'INTEGER2'. 'INTEGER2' - THE LINE NUMBER OF THE FINAL RECORD TO BE PRINTED. LIST Page 82 LIST NUM('BEGIN INTEGER','LENGTH') - NUM INDICATES THAT THE DATA SET(S) TO BE LISTED HAVE SEQUENCE FIELDS,WHICH WILL APPEAR ON THE LEFT OF THE OUTPUT. 'BEGIN INTEGER' SPECIFIES THE BEGINNING COLUMN OF THE SEQUENCE FIELD. 'LENGTH' SPECIFIES THE LENGTH OF THE SEQUENCE FIELD. SNUM('BEGIN COLUMN' 'LENGTH') - THE SEQUENCE FIELD OF THE RECORD(S) IS NOT TO BE PRINTED. 'BEGIN COLUMN' IS THE POSITION OF THE FIRST COLUMN OF THE SEQUENCE FIELD. 'LENGTH' IS THE LENGTH OF THE SEQUENCE FIELD. NONUM - THE SEQUENCE FIELD OF THE DATA RECORD(S) IS TO BE IGNORED. COL('BEGIN COLUMN':'END COLUMN',....) - THE 'BEGIN COLUMN' AND 'END COLUMN' ARE SPECIFIED IN PAIRS. THE FIRST INTEGER OF THE PAIR INDICATES THE FIRST COLUMN TO BE PRINTED AND THE SECOND INTEGER OF THE PAIR INDICATES THE LAST COLUMN TO BE PRINTED. COMMAND NAME - LISTALC FUNCTION - THE LISTALC COMMAND IS USED TO DISPLAY THE NAMES OF CURRENTLY ALLOCATED DATA SETS. SYNTAX - LISTALC STATUS HISTORY MEMBERS SYSNAMES REQUIRED - NONE DEFAULTS - NONE OPERANDS - STATUS - DDNAME AND DATA SET DISPOSITION ARE DISPLAYED. HISTORY- CREATION AND EXPIRATION DATES, DATA SET ORGANIZATION AND SECURITY STATUS ARE DISPLAYED. LISTALC Page 83 LISTALC MEMBERS- MEMBER AND ALIAS NAMES OF PARTITIONED DATA SETS ARE DISPLAYED. SYSNAMES - SYSTEM ASSIGNED NAMES ARE DISPLAYED. COMMAND NAME - LISTBC LISTBC FUNCTION - THIS COMMAND IS USED TO LIST THE MESSAGES SAVED IN THE BROADCAST DATA SET.EITHER THE GENERAL MESSAGES (NOTICES) INTENDED FOR ALL USERS,OR UNIQUE MESSAGES (MAIL) INTENDED FOR SPECIFIC USERS, OR BOTH SETS,CAN BE LISTED. SYNTAX - LISTBC MAIL / NOMAIL NOTICES / NONOTICES REQUIRED - NONE DEFAULTS - MAIL, NOTICES ALIAS- LISTB OPERANDS - MAIL - REQUESTS LISTING THE MESSAGES SPECIFIC FOR THE USER WHO ENTERED THE LISTBC COMMAND. NOMAIL - SUPPRESSES THE PRINTING OF USER MESSAGES. NOTICES- REQUESTS LISTING OF MESSAGES WHICH ARE FOR GENERAL BROADCAST TO ALL USERS. NONOTICES- SUPPRESSES THE PRINTING OF BROADCAST MESSAGES. LISTCAT Page 84 LISTCAT COMMAND NAME - LISTCAT FUNCTION - THE LISTCAT COMMAND LISTS ENTRIES FROM EITHER THE MASTER CATALOG OR A USER CATALOG. SYNTAX - LISTCAT CATALOG('CATNAME/PASSWORD') OUTFILE('DNAME') LEVEL('LEVEL') | ENTRIES('ENTRYNAME/PASSWORD' ...) CREATION('NNNN') EXPIRATION('NNNN') NOTUSABLE CLUSTER DATA INDEX ALIAS SPACE NONVSAM USERCATALOG GENERATIONDATAGROUP PAGESPACE ALTERNATEINDEX PATH ALL | NAME | HISTORY | VOLUME | ALLOCATION REQUIRED - NONE DEFAULTS - NAME ABBREVIATIONS - NOTE - IN ADDITION TO NORMAL TSO SHORT FORMS, THESE ARE ACCEPTED. LISTCAT LISTC OUTFILE OFILE LEVEL LVL NOTUSABLE NUS INDEX IX SPACE SPC NONVSAM NVSAM USERCATALOG UCAT GENERATIONDATAGROUP GDG PAGESPACE PGSPC ALTERNATEINDEX AIX OPERANDS - CATALOG('CATNAME/PASSWORD') - SPECIFIES THE NAME OF THE CATALOG CONTAINING THE ENTRIES TO BE LISTED. 'CATNAME' - NAME OF THE CATALOG CONTAINING THE ENTRIES TO BE LISTED. 'PASSWORD' - PASSWORD OF THE CATALOG CONTAINING THE ENTRIES TO BE LISTED. REQUIRED - 'CATNAME' LISTCAT Page 85 LISTCAT OUTFILE('DNAME') - IDENTIFIES THE ALTERNATE OUTPUT DATA SET. 'DNAME'- NAME OF THE JCL STATEMENT THAT IDENTIFIES THE ALTERNATE OUTPUT DATA SET. LEVEL('LEVEL') - SPECIFIES THE LEVEL OF ENTRY NAMES TO BE LISTED. 'LEVEL'- LEVEL OF ENTRY NAMES TO BE LISTED. ENTRIES('ENTRYNAME/PASSWORD' ...) - THE NAMES OF THE INDIVIDUAL ENTRIES TO BE LISTED. 'ENTRYNAME' - NAME OF THE OBJECT WHOSE ENTRY IS TO BE LISTED. 'PASSWORD' - PASSWORD OF PASSWORD-PROTECTED CLUSTER OR COMPONENT OR OBJECT. REQUIRED - 'ENTRYNAME' CREATION('NNNN') - SELECTION OF OBJECTS LISTED BY CREATION DATE. 'NNNN' - OBJECTS LISTED IF CREATED 'NNNN' DAYS AGO OR EARLIER, WHERE 'NNNN' IS A DECIMAL NUMBER 0 - 9999. EXPIRATION('NNNN') - SELECTION OF OBJECTS LISTED BY EXPIRATION DATE. 'NNNN' - OBJECTS LISTED IF EXPIRING 'NNNN' DAYS HENCE OR EARLIER, WHERE 'NNNN' IS A DECIMAL NUMBER 0 - 9999. NOTUSABLE - THE ENTRIES FOR DATA AND INDEX COMPONENTS THAT ARE MARKED AS UNUSABLE ARE TO BE LISTED. CLUSTER- THE CLUSTER ENTRIES ARE TO BE LISTED. DATA - THE ENTRIES FOR DATA COMPONENTS ARE TO BE LISTED. INDEX - THE ENTRIES FOR INDEX COMPONENTS ARE TO BE LISTED. ALIAS - THE ALIAS ENTRIES ARE TO BE LISTED. LISTCAT Page 86 LISTCAT SPACE- THE ENTRIES FOR VOLUMES CONTAINING VSAM DATA SPACES ARE TO BE LISTED. SPACE IS MUTUALLY EXCLUSIVE WITH OTHER ENTRY TYPES. NONVSAM- THE ENTRIES FOR NONVSAM DATA SETS ARE TO BE LISTED. USERCATALOG - THE ENTRIES FOR USER CATALOGS ARE TO BE LISTED. GENERATIONDATAGROUP - THE ENTRIES FOR GENERATION DATA GROUPS ARE TO BE LISTED. PAGESPACE - THE ENTRIES FOR PAGE SPACES ARE TO BE LISTED. ALTERNATEINDEX - THE ALTERNATEINDEX ENTRIES ARE TO BE LISTED. PATH - THE PATH ENTRIES ARE TO BE LISTED. ALL - ALL THE FIELDS ARE TO BE LISTED FOR EACH CATALOG ENTRY. NAME - THE NAME AND ENTRY TYPE OF THE CATALOGED OBJECTS ARE TO BE LISTED. HISTORY- THE INFORMATION PROVIDED BY SPECIFYING NAME AND OWNER IDENTIFICATION, CREATION DATE, EXPIRATION DATE AND CATALOG RECOVERY INFORMATION FOR THE OBJECTS IS TO BE LISTED. VOLUME - THE INFORMATION PROVIDED BY SPECIFYING HISTORY AND VOLUME SERIAL NUMBERS AND DEVICE TYPES ALLOCATED TO THE OBJECTS IS TO BE LISTED. ALLOCATION - THE INFORMATION PROVIDED BY SPECIFYING VOLUME AND DETAILED INFORMATION ABOUT THE ALLOCATION ARE TO BE LISTED. LISTDS Page 87 LISTDS COMMAND NAME - LISTDS FUNCTION - THE LISTDS COMMAND DISPLAYS BASIC ATTRIBUTES OF DATA SETS SPECIFIED. MANY OF THE FUNCTIONS OF THIS COMMAND HAVE BEEN ABSORBED INTO THE TSO COMMANDS "SPACE" AND "MEMBERS". FOR LISTING INDIVIDUAL DATA SET ATTRIBUTES, THE LISTDS COMMAND REMAINS THE MOST EFFICIENT. SYNTAX - LISTDS 'DSLIST' STATUS HISTORY MEMBERS LABEL CATALOG('CAT.NAME') LEVEL REQUIRED - 'DSLIST' DEFAULTS - NONE OPERANDS - 'DSLIST' - NAMES OF DATA SETS FOR WHICH INFORMATION IS REQUESTED. STATUS - DDNAME AND DATA SET DISPOSITION ARE DISPLAYED. HISTORY- CREATION AND EXPIRATION DATES, DATA SET ORGANIZATION AND SECURITY STATUS ARE DISPLAYED. MEMBERS- MEMBER AND ALIAS NAMES OF PARTITIONED DATA SETS ARE DISPLAYED. LABEL - THE CHAIN OF DSCB'S FOR THE DATA SET ON A DIRECT ACCESS DEVICE ARE LISTED. CATALOG('CAT.NAME') - CATALOG IS REQUIRED ONLY IF THE NAMES ARE IN A CATALOG OTHER THAN STEPCAT OR THE CATALOG IMPLIED BY THE FIRST LEVEL QUALIFIER OF THE NAME. ('CAT.NAME') - SPECIFIES THE USER CATALOG THAT CONTAINS THE NAMES IN THE DATA SET LIST. LEVEL - CATALOGED DATA SETS WITH NAMES BEGINNING WITH SPECIFIED QUALIFIER ARE LISTED. WHEN LEVEL SPECIFIED, NAMES CANNOT CONTAIN ASTERISKS. LOADGO Page 88 LOADGO COMMAND NAME - LOADGO FUNCTION - THE LOADGO COMMAND IS USED TO INVOKE THE O.S. LOADER WHICH LOADS A PROGRAM, RESOLVES EXTERNAL REFERENCES, AND EXECUTES THE PROGRAM. SYNTAX - LOADGO 'DSLIST' ''PARMS'' PRINT('DSNAME')/NOPRINT LIB('KWDSLIST') COBLIB PLILIB FORTLIB PLIBASE PLICMIX RES/NORES MAP/NOMAP CALL/NOCALL TERM/ NOTERM LET/NOLET SIZE('INTEGER') EP('ENTRYNAME') NAME('PROGNAME') REQUIRED - 'DSLIST' DEFAULTS - NOPRINT RES NOMAP CALL TERM NOLET ALIAS- LOAD OPERANDS - 'DSLIST' - LIST OF INPUT DATA SET NAMES. ''PARMS''- PARAMETER STRING (ENCLOSED IN QUOTES) TO BE PASSED TO THE USER'S PROGRAM. PRINT('DSNAME') - LOADER LISTINGS WILL BE PRODUCED. 'DSNAME' - OPTIONAL PARAMETER TO SPECIFY A DATA SET TO BE USED FOR THE LISTINGS. TO DISPLAY LISTINGS AT THE TERMINAL, CODE '*' FOR 'DSNAME'. NOPRINT- NO LOADER LISTINGS WILL BE PRODUCED. LIB('KWDSLIST') - LIBRARIES WILL BE USED TO RESOLVE EXTERNAL REFERENCES. 'KWDSLIST' - LIST OF THE LIBRARY NAMES TO BE USED. COBLIB - SYS1.COBLIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. PLILIB - SYS1.PL1LIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. FORTLIB- SYS1.FORTLIB WILL BE USED TO RESOLVE EXTERNAL REFERENCES. LOADGO Page 89 LOADGO PLIBASE- SYS1.PLIBASE WILL BE USED TO RESOLVE EXTERNAL REFERENCES. PLICMIX- SYS1.PLICMIX WILL BE USED TO RESOLVE EXTERNAL REFERENCES. RES - LINK PACK AREA TO BE USED TO RESOLVE EXTERNAL REFERENCES. NORES - LINK PACK AREA NOT USED TO RESOLVE EXTERNAL REFERENCES. MAP - A LIST OF EXTERNAL NAMES AND THEIR LOCATIONS WILL BE WRITTEN ON PRINT DATA SET. NOMAP - A LIST OF EXTERNAL NAMES WILL NOT BE PRODUCED. CALL - THE LOADER WILL TRY TO RESOLVE ANY UNRESOLVED EXTERNAL REFERENCES. NOCALL - THE LOADER WILL NOT RESOLVE ANY UNRESOLVED EXTERNAL REFERENCES. TERM - LOADER ERROR MESSAGES WILL BE DISPLAYED AT THE TERMINAL. NOTERM - LOADER ERROR MESSAGES WILL NOT BE DISPLAYED ON TERMINAL. LET - EXECUTION OF USER PROGRAM WILL BE ATTEMPTED EVEN IF SEVERITY 2 ERROR OCCURRED. NOLET - EXECUTION OF USER PROGRAM WILL NOT BE ATTEMPTED IF SEVERITY 2 ERROR OCCURRED. SIZE('INTEGER') - SPECIFIES NUMBER OF BYTES OF STORAGE TO BE USED FOR LOADER PROCESSING. EP('ENTRYNAME') - SPECIFIES THE ENTRY POINT OF USER PROGRAM. LOADGO Page 90 LOADGO NAME('PROGNAME') - SPECIFIES NAME TO BE USED FOR USER PROGRAM. COMMAND NAME - LOCATE FUNCTION - THE LOCATE COMMAND SETS THE SYSTEM RETURN CODE AND CAN BE USED TO DETERMINE IF: 1) A GIVEN DATA SET NAME ENTRY EXISTS IN THE SYSTEM CATALOG. 2) A GIVEN DATA SET NAME ENTRY EXISTS BOTH IN THE SYSTEM CATALOG, AND ON THE VOLUME SPECIFIED IN THE CATALOG. 3) A GIVEN PARTITIONED DATA SET MEMBER EXISTS. SYNTAX LOCATE 'DSNAME' MEMBER VTOC REQUIRED - 'DSNAME' DEFAULTS - 'VTOC' IS ASSUMED WHEN 'MEMBER' IS PRESENT OPERANDS - DSNAME- THE DATA SET NAME TO BE SEARCHED FOR. A MEMBER NAME IN THE DATA SET NAME WILL BE IGNORED UNLESS THE 'MEMBER' KEYWORD IS PRESENT. AN ASTERISK FOR THE DATA SET NAME WILL RESULT IN A RETURN CODE OF 0. MEMBER- IF SPECIFIED A SEARCH WILL BE MADE FOR THE GIVEN MEMBER OF THE GIVEN PARTITIONED DATA SET. VTOC - IF SPECIFIED, THE VTOC OF THE VOLUME GIVEN IN THE SYSTEM CATALOG WILL BE SEARCHED FOR AN ENTRY FOR 'DSNAME'. RETURNCODES - 00 - DATA SET FOUND IN SYSTEM CATALOG. IF 'VTOC' WAS SPECIFIED, THE VTOC ENTRY WAS FOUND. IF 'MEMBER' WAS SPECIFIED, THE GIVEN MEMBER WAS FOUND. 04 - DATA SET NAME IN SYSTEM CATALOG. VOLUME NOT MOUNTED. 08 - DATA SET NAME NOT FOUND IN SYSTEM CATALOG. 12 - DATA SET NAME IN CATALOG. NO VTOC ENTRY WAS FOUND. 16 - DATA SET NAME IN CATALOG. VTOC ENTRY FOUND. 'MEMBER' WAS LOCATE Page 91 LOCATE SPECIFIED, BUT THE GIVEN MEMBER WAS NOT FOUND. 20 - DATA SET NAME IN CATALOG. VTOC ENTRY FOUND. 'MEMBER' WAS SPECIFIED, BUT THE DATA SET WAS NOT PARTITIONED. 24 - DATA SET NAME IN CATALOG. VTOC ENTRY FOUND. 'MEMBER' WAS SPECIFIED, BUT DATA SET ALLOCATION OR OPENING FAILED. 28 - SYNTAX ERROR IN COMMAND 32 - AN ERROR OCCURED DURING PROCESSING. COMMAND NAME - LOGOFF FUNCTION - LOGOFF TERMINATES THE USER'S CURRENT TERMINAL SESSION SYNTAX - LOGOFF DISCONNECT/HOLD DEFAULT - DISCONNECT OPERANDS - DISCONNECT - SPECIFIES THAT THE LINE IS TO BE DROPPED WHEN LOGGED OFF. HOLD - SPECIFIES THAT THE LINE IS NOT TO BE DROPPED. THE USER MAY RELOGON WITHOUT REDIALING INTO THE SYSTEM. NOTE: THE 'HOLD' OPERAND IS NOT SUPPORTED WITH TMP LOGOFF FROM TERMINALS USING TSO/VTAM. COMMAND NAME - LOGON FUNCTION - THE LOGON COMMAND INITIATES A TERMINAL JOB. LOGON Page 92 LOGON SYNTAX - LOGON 'ID' ACCT('ACCOUNT') PROC('PROCEDURE') SIZE('INTEGER') PERFORM('INTEGER') GROUP('GROUP-ID') OIDCARD MAIL/NOMAIL NOTICES/NONOTICES OR LOGON 'ID' RECONNECT REQUIRED - 'ID' DEFAULTS - ACCOUNT - NULL STRING PERFORM - SUPPLIED BY OPTIMIZER GROUP - DEFAULT FROM RACF PROFILE MAIL NOTICES - WHEN USING TERMINALS SUPPORTED BY TSO/VTAM, THE LOGON FROM THESE DEVICES WILL BE INSTALLATION DEFINED. SEE YOUR SYSTEM PROGRAMMER FOR YOUR INSTALLATIONS REQUIREMENTS. OPERANDS - 'ID' - IS A USER'S IDENTIFICATION TO THE SYSTEM. THE 'ID' CONSISTS OF 'USERID/CURRENT-PASSWORD/NEW-PASSWORD'. IF THE USER DOES NOT HAVE PASSWORDS THEN '/CURRENT-PASSWORD' IS OPTIONAL AND '/NEW-PASSWORD' IS IGNORED. '/NEW-PASSWORD' IS VALID ONLY FOR RACF USERS. IT WILL BECOME THE '/CURRENT-PASSWORD' THE NEXT TIME THE USER LOGS ON. IT WILL BE IGNORED FOR NON RACF USERS. ACCT('ACCOUNT') - 'ACCOUNT' IS THE INFORMATION REQUIRED BY THE INSTALLATION ACCOUNTING ROUTINES. PROC('PROCEDURE') - 'PROCEDURE' IS THE NAME OF A CATALOGUED PROCEDURE WHICH IDENTIFIES THE SYSTEM RESOURCES REQUIRED FOR A TERMINAL JOB. SIZE('INTEGER') - 'INTEGER' IS THE UPPER BOUND ON THE SIZE OF A VARIABLE CONDITIONAL GETMAIN WHICH CAN BE SATISFIED. PERFORM('INTEGER') - 'INTEGER' IS A NUMBER FROM 1 TO 999, INCLUSIVE, INDICATING A PERFORMANCE GROUP FOR THIS SESSION. GROUP('GROUP-ID') - 'GROUP-ID' IS VALID ONLY FOR RACF DEFINED USERS. LOGON Page 93 LOGON IT IS A 1 TO 8 CHARACTER ID COMPOSED OF ALPHANUMERIC AND/OR NATIONAL CHARACTERS, THE FIRST OF WHICH MUST BE ALPHABETIC OR NATIONAL. IT WILL BE IGNORED FOR NON RACF USERS. OIDCARD- 'OIDCARD' IS VALID ONLY FOR RACF DEFINED USERS. SPECIFYING 'OIDCARD' ON LOGON WILL CAUSE THE USER TO BE PROMPTED FOR AN OPERATOR IDENTIFICATION CARD, EVEN IF AN OIDCARD IS NOT REQUIRED. THE OPERATOR IDENTIFICATION CARD WILL ONLY BE ACCEPTED AFTER THE USER HAS BEEN PROMPTED TO ENTER ONE. IT WILL BE IGNORED FOR NON RACF USERS. MAIL - SPECIFIES THAT ALL MESSAGES QUEUED ON THE BROADCAST DATA SET FOR THE USER ARE TO BE TRANSMITTED TO THE TERMINAL DURING LOGON PROCESSING AND THEN DELETED FROM THE DATA SET NOMAIL - SPECIFIES THAT THE MESSAGES QUEUED ON THE BROADCAST DATA SET FOR THE USER ARE TO REMAIN QUEUED THERE FOR LATER TRANSMISSION. NOTICES- SPECIFIES THAT THE MESSAGES QUEUED ON THE BROADCAST DATA SET WHICH ARE OF INTEREST TO ALL USERS SHOULD BE TRANSMITTED TO THE TERMINAL DURING LOGON PROCESSING. NONOTICES - SPECIFIES THAT THE MESSAGES QUEUED ON THE BROADCAST DATA SET WHICH ARE OF INTEREST TO ALL USERS SHOULD NOT BE TRANSMITTED TO THE TERMINAL DURING LOGON PROCESSING. RECONNECT - IF A USER'S LINE HAS BEEN DISCONNECTED HE MAY RELOGON USING THIS OPERAND - WHICH IS MUTUALLY EXCLUSIVE OF ALL OTHERS. THE PASSWORD, IF ANY, USED WITH THE DISCONNECTED SESSION MUST BE USED WITH LOGON 'ID' RECONNECT. MEMBERS Page 94 MEMBERS COMMAND NAME - MEMBERS FUNCTION - THE MEMBERS COMMAND IS USED TO OBTAIN A FORMATTED LIST OF THE NAMES OF THE MEMBERS OF A PARTITIONED DATA SET. SYNTAX - MEMBERS'DATASET-LIST' PRINT( * / 'PRINT-DSNAME') SYSOUT('CLASSNAME') FROM('MEMBER-SUBSTRING') LIKE('MEMBER-SUBSTRING') SUBS('MEMBER-SUBSTRING') REQUIRED - 'DATASET-LIST' DEFAULTS - PRINT(*), IF SYSOUT IS SPECIFIED, CLASSNAME DEFAULTS TO 'A' ALIASES- MEM NOTE: A MEMBER NAME WHICH IS AN ALIAS IS FOLLOWED BY AN ASTERISK IN THE LISTING. THE KEYWORDS PRINT AND SYSOUT ARE MUTUALLY EXCLUSIVE. IF BOTH ARE SPECIFIED, SYSOUT IS USED. THE KEYWORDS FROM,LIKE AND SUBS ARE MUTUALLY EXCLUSIVE. OPERANDS - 'DATASET-LIST' - NAME OF PARTITIONED DATA SET FOR WHICH A LIST OF MEMBER NAMES IS WANTED, OR A LIST OF DATA SETS ENCLOSED IN PARENTHESES. PRINT - SPECIFIES THAT THE LISTINGS ARE TO BE WRITTEN TO A DATA SET. 'PRINT-DSNAME' - THE NAME OF THE DATA SET INTO WHICH THE LISTING IS TO BE WRITTEN. IF A NEW DATA SET MUST BE CREATED .LIST IS ADDED AS LAST QUALIFIER. * - ALL OUTPUT AND LISTINGS ARE TO PRINTED AT THE TERMINAL. SYSOUT - SPECIFIES THAT THE LISTINGS ARE TO BE WRITTEN TO SYSOUT. 'CLASSNAME' - OPTIONAL, IT SPECIFIES WHICH SYSOUT CLASS WILL RECIEVE THE LISTING. MEMBERS Page 95 MEMBERS FROM -LIMITS LISTING TO MEMBERS WHICH ARE ALPHABETICALLY GREATER OR EQUAL TO THE GIVEN MEMBER-SUBSTRING. 'MEMBER-SUBSTRING' -A STRING OF LENGTH 1 TO 8 CHARACTERS, THE FIRST BEING ALPHA OR NATIONAL, ANY OTHERS BEING ALPHA, NATIONAL, OR NUMERIC. LIKE -LIMITS THE LISTING TO MEMBERS WHICH BEGIN WITH THE GIVEN MEMBER SUBSTRING. 'MEMBER-SUBSTRING' -A STRING OF LENGTH 1 TO 8 CHARACTERS, THE FIRST BEING ALPHA OR NATIONAL, ANY OTHERS BEING ALPHA, NATIONAL, OR NUMERIC. SUBS - (SUBSTRING) LIMITS THE LISTING TO MEMBERS IN WHICH THE MEMBER-SUBSTRING CAN BE FOUND. 'MEMBER-SUBSTRING' -A STRING OF LENGTH 1 TO 8 CHARACTERS, ALL ALPHANUMERIC OR NATIONAL. COMMAND NAME - MERGE FUNCTION- THE MERGE COMMAND IS USED TO COMBINE DATA SETS OR PARTS OF DATA SETS AND ALSO TO COPY A DATA SET OR PARTIAL DATA SET. SYNTAX - MERGE 'DSNAME1' 'INTEGER1' 'INTEGER2' 'DSNAME2' 'INTEGER3' NUM('BEGIN INTEGER' 'LENGTH') OR NONUM NUM2('BEGIN INTEGER' 'LENGTH') OR NONUM2 RENUM('BEGIN INTEGER' 'INCREMENT') BASIC REQUIRED - 'DSNAME1' AND 'DSNAME2' DEFAULTS - 'NUM' AND 'NUM2' NOTE - IF 'INTEGER2' IS OMITTED THE LINE SPECIFIED BY 'INTEGER1' IS MERGED. IF 'INTEGER1' IS ALSO OMITTED THE ENTIRE DATA SET IS MERGED OR COPIED. MERGE Page 96 MERGE OPERANDS 'DSNAME1'- THE NAME OF THE DATA SET FROM WHICH RECORDS WILL BE MERGED OR COPIED. 'INTEGER1' 'INTEGER2' - INTEGERS SPECIFYING THE RANGE OF LINE OR RECORD NUMBERS TO BE MERGED OR COPIED FROM 'DSNAME1'. 'DSNAME2' - THE NAME OF THE DATA SET INTO WHICH THE DATA SPECIFIED BY 'DSNAME1' WILL BE MERGED OR COPIED. 'INTEGER3' - AN INTEGER SPECIFYING THE LINE OR RECORD NUMBER IN 'DSNAME2' AFTER WHICH THE DATA SPECIFIED BY 'DSNAME1' WILL BE MERGED. NUM('BEGIN INTEGER' 'LENGTH') - INDICATES THAT DATA SET 'DSNAME1' HAS SEQUENCE FIELDS. NOTE - IF 'NUM' IS SPECIFIED WITHOUT ANY VALUES THE DEFAULT VALUES WILL BE ASSIGNED BASED ON THE DATA SET TYPE. 'BEGIN INTEGER' - SPECIFIES THE BEGINNING COLUMN OF THE SEQUENCE FIELD. 'LENGTH' - SPECIFIES THE LENGTH OF THE SEQUENCE FIELD. NONUM - SPECIFIES THAT DATASET 'DSNAME1' HAS NO SEQUENCE FIELDS. NUM2('BEGIN INTEGER' 'LENGTH') - INDICATES THAT DATA SET 'DSNAME2' HAS SEQUENCE FIELDS. NOTE - IF 'NUM2' IS SPECIFIED WITHOUT ANY VALUES THE DEFAULT VALUES WILL BE ASSIGNED BASED ON THE DATA SET TYPE. 'BEGIN INTEGER' - SPECIFIES THE BEGINNING COLUMN OF THE SEQUENCE FIELD. 'LENGTH' - SPECIFIES THE LENGTH OF THE SEQUENCE FIELD. NONUM2 - SPECIFIES THAT DATASET 'DSNAME2' HAS NO SEQUENCE FIELDS. RENUM('BEGIN INTEGER' 'INCREMENT') - MAY BE USED TO RESEQUENCE THE OUTPUT DATA SET. IF 'RENUM' IS SPECIFIED WITHOUT ANY VALUES THE 'BEGIN INTEGER' AND 'INCREMENT' WILL BOTH BE 10. 'BEGIN INTEGER' - SPECIFIES THE BEGINNING SEQUENCE NUMBER TO BE USED. 'INCREMENT' - SPECIFIES THE INCREMENT VALUE BY WHICH EACH OUTPUT RECORD SEQUENCE FIELD WILL BE INCREASED. MERGE Page 97 MERGE BASIC- SPECIFIES THAT THE DATA SETS BEING USED ARE DATA SETS WITH ITF BASIC ATTRIBUTES. THIS KEYWORD SHOULD NOT BE ENTERED ON OTHER THAN BASIC DATA SETS. VSBASIC - SPECIFIES THAT DATA-SET-NAME1 AND DATA-SET-NAME2 ARE WRITTEN IN VS BASIC. DO NOT ENTER THIS OPERAND UNLESS YOUR TSO INSTALLATION INCLUDES VS BASIC. WHEN USING THIS KEYWORD, BOTH DATA SETS MUST BE OLD AND BOTH MUST CONTAIN STANDARD VS BASIC RECORDS. COMMAND NAME - MINITAB2 FUNCTION - THE MINITAB2 COMMAND INVOKES THE MINITAB II STATISTICAL PROGRAM. THIS PROGRAM IS A COLLECTION OF UNIVARIATE STATISTICAL ROUTINES AND MATHEMATICAL OPERATIONS. THE ROUTINES AND OPERATIONS ARE CALLED THROUGH A SIMPLE CONTROL LANGUAGE. THE CONTROL LANGUAGE AND CAPABILITIES OF MINITAB ARE DESCRIBED IN DETAIL IN THE MINITAB II USER'S GUIDE. SYNTAX - MINITAB2 INPUT('DATASET NAME') OUTPUT('DATASET NAME') SAVE('DATASET NAME') DATA('DATASET NAME') PUNCH('DATASET NAME') VER(3 OR 2) REQUIRED - NONE DEFAULTS - INPUT(*), OUTPUT(*), VER(3) NOTE - YOU WILL BE PROMPTED FOR FILE ALLOCATIONS AND BE TOLD WHAT DATA SETS WERE SPECIFIED FOR INPUT, SAVE, ETC. VER(3) IS THE NEW (DEFAULT) VERSION. SPECIFY VER(2) FOR THE OLDER MINITAB. OPERANDS - INPUT('DATASET NAME') - SPECIFIES THE NAME OF THE DATASET CONTAINING MINITAB II SOURCE STATEMENTS. THE DEFAULT IS (*) ; STATEMENTS WILL BE ENTERED FROM THE TERMINAL. MINITAB2 Page 98 MINITAB2 OUTPUT('DATASET NAME') - SPECIFIES THE NAME OF THE DATASET WHICH IS TO CONTAIN THE OUTPUT FROM A MINITAB II SESSION. THE DEFAULT IS (*) ; ALL OUTPUT WILL APPEAR AT THE TERMINAL. SAVE('DATASET NAME') - SPECIFIES NAME OF THE DATASET TO BE USED FOR A SAVE FILE IN CONJUNCTION WITH THE 'SAVE' AND 'RETRIEVE' MINITAB II SUBCOMMANDS. MINITAB II CAN USE A PREVIOUSLY CREATED DATASET OR CREATE A NEW ONE. DEFAULT IS () ; NO SAVE FILE. DATA('DATASET NAME') - SPECIFIES THE NAME OF A DATASET CONTAINING DATA FOR INPUT TO MINITAB II VIA THE 'TAPE READ' MINITAB II COMMAND. THIS DATASET IS THE FORTRAN LOGICAL UNIT 8. PUNCH('DATASET NAME') - INDICATES THE NAME OF A NEW OR OLD DATA SET WHICH WILL BE WRITTEN INTO VIA THE MINITAB COMMANDS 'PUNCH' OR 'FPUNCH'. THIS DATA SET IS FORTRAN LOGICAL UNIT 7. VER(3 OR 2) - THE NEW MINITAB IS THE DEFAULT VERSION CALLED VER(3). TO CONTINUE USING THE OLDER VERSION, SPECIFY VER(2). COMMAND NAME - MODESET FUNCTION - THE MODESET COMMAND IS USED TO SET THE USER'S DATASET PREFIX. THIS PREFIX IS USED AS THE FIRST LEVEL INDEX OF ANY DATASET REFERENCED FROM TSO THAT WAS NOT ENTERED IN QUOTES. SYNTAX - MODESET MASTER/SUB/PROJECT/DEFAULT LIST DEFAULTS - MODESET DEFAULTS TO THE PREFIX SPECIFIED BY PFX-SUB/PFX-MAST/PFX-PRJ IN THE USERS SUB ACCOUNT MODESET Page 99 MODESET RECORD OR TO PROJECT IF NO VALUE IS SPECIFIED IN THE SUB ACCOUNT RECORD. NOTE- JUST SPECIFYING 'LIST' PRODUCES A LIST BUT DOESN'T CHANGE THE PREFIX. OPERANDS - MASTER THE USER'S MASTER ACCOUNT UNIQUE ID NUMBER WILL BE USED AS THE DATASET PREFIX. SUB THE USER'S SUB ACCOUNT UNIQUE ID NUMBER WILL BE USED AS THE DATASET PREFIX. PROJECT THE USER'S PROJECT NAME (FIRST SEVEN CHARACTERS OF THE ACCOUNT NAME - NINH379) IS USED AS THE DATASET PREFIX. DEFAULT THE PREFIX SPECIFIED IN THE USER'S ACCOUNT RECORD WILL BE USED OR PROJECT MODE WILL BE USED IF NO VALUE IS SPECIFIED IN THE USER'S ACCOUNT RECORD. LIST THE LIST KEYWORD IS USED TO REQUEST THAT MODESET ALSO PRODUCE A LISTING OF THE FOLLOWING - - CURRENT PREFIX - DEFAULT PREFIX - SUB PREFIX - MASTER PREFIX - PROJECT PREFIX MPSGEN Page 100 MPSGEN COMMAND NAME - MPSGEN FUNCTION - THE MPSGEN COMMAND IS USED TO CREATE A DATA SET THAT CAN CAN BE SCHEDULED IN BATCH TO EXECUTE THE MPSX LINEAR PROGRAMMING PACKAGE. A FAMILIARITY WITH MPSX IS ASSUMED. SYNTAX - MPSGEN 'OUTPUT-DSNAME' OPERANDS - 'OUTPUT-DSNAME' - THE NAME OF THE DATA SET TO BE CREATED IF IT EXISTS THE USER WILL BE ASKED IF REUSE IS PERMITTED. IF Y IS ENTERED THE DATA SET WILL BE OVERWRITTEN. COMMAND NAME - PLC FUNCTION - THE PLC COMMAND IS USED TO COMPILE AND EXECUTE JOBS UNDER THE PL/C COMPILER FROM THE USER'S TERMINAL. SYNTAX - PLC'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE ALIASES- NONE OPERANDS - 'DSNAME' - THE NAME OF THE PLC SOURCE DATA SET WHICH IS TO RUN UNDER THE PL/C COMPILER. NOTE: OPTIONS FOR THE PL/C COMPILER ARE SPECIFIED ON THE $PLC CARD. PLC Page 101 PLC SUBCOMMANDS - NONE COMMAND NAME - PLI NO SUBCOMMANDS FUNCTION - THE PLI COMMAND IS USED TO INVOKE THE PL/1 OPTIMIZING COMPILER SYNTAX - PLI 'DSNAME' PRINT(*/'DSNAME' 'INTEGER1' 'INTRGER2')/NOPRINT/ SYSPRINT('CLASSNAME' 'INTEGER1' 'INTEGER2') LIB('DSLIST') AGGREGATE/NOAGGREGATE/AG/NAG ATTRIBUTES(FULL/SHORT)/NOATTRIBUTES/A(F/S)/NA CHARSET(48/60 EBCDIC/BCD)/CS(48/60 EB/B) COMPILE/NOCOMPILE(W/E/S)/C/NC(W/E/S) CONTROL('PASSWORD') DECK('DSNAME')/NODECK/D('DSNAME')/ND DUMP/NODUMP/DU/NDU ESD/NOESD FLAG(I/W/E/S)/F(I/W/E/S) FLOW('INTEGER1' 'INTEGER2')/NOFLOW GONUMBER/NOGONUMBER/GN/NGN GOSTMT/NOGOSTMT/GS/NGS INCLUDE/NOINCLUDE/INC/NINC IMPRECISE/NOIMPRECISE/IMP/NIMP INSOURCE/NOINSOURCE/IS/NIS INTERRUPT/NOINTERRUPT/INT/NINT LINECOUNT('INTEGER')/LC('INTEGER') LIST('INTEGER1' 'INTEGER2')/NOLIST LMESSAGE/SMESSAGE/LMSG/SMSG MACRO/NOMACRO/M/NM MAP/NOMAP MARGINI('CHARACTER')/NOMARGINI/MI('CHARACTER')/NMI MARGINS('INTEGER1' 'INTEGER2' 'INTEGER3')/MAR('INTEGER1' 'INTEGER2' 'INTEGER3') MDECK('DSNAME')/NOMDECK/MD('DSNAME')/NMD NAME('NAME')/N('NAME') NEST/NONEST PLI Page 102 PLI NUMBER/NONUMBER/NUM/NNUM OBJECT('DSNAME')/NOOBJECT/OBJ('DSNAME')/NOBJ OFFSET/NOOFFSET/OF/NOF OPTIMIZE(0/2/TIME)/NOOPTIMIZE/OPT(0/2/TIME)/NOPT OPTIONS/NOOPTIONS/OP/NOP SEQUENCE('INTEGER1' 'INTEGER2')/SEQ('INTEGER1' 'INTEGER2') NOSEQUENCE/NSEQ SIZE('INTEGER1'/'INTEGER2'K/-'INTEGER3'/-'INTEGER4'K/ MAX)/ SZ('INTEGER1'/'INTEGER2'K/-'INTEGER3'/ -'INTEGER4'K/MAX) SOURCE/NOSOURCE/S/NS STMT/NOSTMT STORAGE/NOSTORAGE/STG/NSTG SYNTAX/NOSYNTAX(W/E/S)/SYN/NSYN(W/E/S) TERMINAL('OPTION-LIST')/NOTERMINAL/TERM('OPTION-LIST')/ NTERM XREF(FULL/SHORT)/NOXREF/X(F/S)/NX OPERANDS - 'DSNAME' - THE NAME OF DATA SET TO BE COMPILED PRINT(*/'DSNAME' 'INTEGER1' 'INTERGER2') - SPECIFIES DESTINATION OF THE LISTING ON THE SYSPRINT FILE * - IS OPTIONAL AND SPECIFIES THAT THE LISTING ON THE SYSPRINT - FILE IS TO BE WRITTEN AT THE TERMINAL. NO OTHER COPY OF - THE FILE WILL BE AVAILABLE 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS - TO CONTAIN THE LISTING ON THE SYSPRINT FILE. IF IT IS - OMITTED, A NAME IS GENERATED WITH THE QUALIFIER 'LIST' 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE PRIMARY - ALLOCATION FOR A NEW PRINT DATA-SET. THE PRIMARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER1' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE SECONDARY - ALLOCATION FOR A NEW PRINT DATA-SET. THE SECONDARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER2' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED NOPRINT- SPECIFIES THAT NO OUTPUT IS TO BE WRITTEN ON THE SYSPRINT - FILE PLI Page 103 PLI SYSPRINT('CLASSNAME' 'INTEGER1' 'INTEGER2') - SPECIFIES THE LISTING OF THE SYSPRINT FILE IS TO BE PLACED - IN A SYSOUT CLASS 'CLASSNAME' - IS OPTIONAL AND IS THE NAME OF THE SYSOUT CLASS - WHICH IS TO CONTAIN THE LISTING OF THE SYSPRINT FILE. IF - IT IS OMITTED THE SYSGEN DEFAULT CLASS IS ASSUMED 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE PRIMARY - ALLOCATION FOR THE SYSOUT DATA-SET. THE PRIMARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER1' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE SECONDARY - ALLOCATION FOR THE SYSOUT DATA-SET. THE SECONDARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER2' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED LIB('DSLIST') - SPECIFIES THE ONE OR MORE DATA SETS THAT ARE TO BE USED AS - THE SECONDARY INPUT TO THE PREPROCESSOR 'DSLIST' - IS THE DATA SET NAMES OF THE DATA SETS CONTAINING - THE SECONDARY INPUT. THE DATA SETS ARE CONCATENATED - IN THE ORDER SPECIFIED AGGREGATE - SPECIFIES THAT THE AGGREGATE LENGTH TABLE, GIVING THE - LENGTH OF ALL ARRAYS AND MAJOR STRUCTURES, IS TO BE LISTED AG - SHORT FORM OF AGGREGATE NOAGGREGATE - SPECIFIES THAT THE AGGREGATE LENGTH TABLE, GIVING THE - LENGTH OF ALL ARRAYS AND MAJOR STRUCTURES, IS NOT TO BE - LISTED NAG - SHORT FORM OF NOAGGREGATE ATTRIBUTES(FULL/SHORT) - SPECIFIES THAT THE SOURCE PROGRAM IDENTIFIERS AND THEIR - DATA ATTRIBUTES ARE TO BE LISTED PLI Page 104 PLI - IF THE ARGUMENT IS OMITTED THE SYSGEN DEFAULT IS ASSUMED, - UNLESS THE ARGUMENT IS SPECIFIED FOR THE XREF OPERAND FULL - IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE INCLUDED IN THE LISTING SHORT- IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE OMITTED FROM THE LISTING A(F/S) - SHORT FORM OF ATTRIBUTES NOATTRIBUTES - SPECIFIES THAT THE SOURCE PROGRAM IDENTIFIERS AND THEIR - DATA ATTRIBUTES ARE NOT TO BE LISTED NA - SHORT FORM OF NOATTRIBUTES CHARSET(48/60 EBCDIC/BCD) - SPECIFIES THE CHARACTER SET AND DATA CODE OF THE SOURCE - PROGRAM. BOTH ARGUMENTS ARE OPTIONAL AND THE SYSGEN - DEFAULT IS ASSUMED FOR AN OMITTED ARGUMENT 48 - THE SOURCE PROGRAM IS WRITTEN IN 48-CHARACTER SET 60 - THE SOURCE PROGRAM IS WRITTEN IN 60-CHARACTER SET EBCDIC - THE SOURCE PROGRAM IS WRITTEN IN EXTENDED BINARY CODED - DECIMAL INTERCHANGE CODE BCD - THE SOURCE PROGRAM IS WRITTEN IN BINARY CODED DECIMAL CODE CS(48/60 EB/B) - SHORT FORM OF CHARSET COMPILE- SPECIFIES THAT THE SOURCE PROGRAM IS TO BE COMPILED AFTER - SYNTAX CHECKING C - SHORT FORM OF COMPILE NOCOMPILE(W/E/S) - WITHOUT ARGUMENT, SPECIFIES THAT THE COMPILATION IS - TERMINATED AFTER SYNTAX CHECKING. - WITH ARGUMENT, SPECIFIES THAT THE COMPILATION IS - CONDITIONAL ON THE SEVERITY OF THE MESSAGES GENERATED BY - THE PREPROCESSOR, OR DURING SYNTAX CHECKING W - NO COMPILATION IF WARNING, ERROR, SEVERE OR UNRECOVERABLE - ERROR MESSAGES ARE ISSUED E - NO COMPILATION IF ERROR, SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED PLI Page 105 PLI S - NO COMPILATION IF SEVERE OR UNRECOVERABLE ERROR MESSAGES - ARE PRODUCED NC(W/E/S) - SHORT FORM OF NOCOMPILE CONTROL('PASSWORD') - SPECIFIES THAT ANY COMPILER OPTION DELETED FOR THE - INSTALLATION ARE AVAILABLE FOR THIS COMPILATION 'PASSWORD' - IS A CHARACTER STRING, NOT EXCEEDING EIGHT CHARACTERS COUNT - SPECIFIES THAT THE FREQUENCY OF EXECUTION OF STATEMENTS - IS TO BE LISTED CT - SHORT FORM OF COUNT NOCOUNT- SPECIFIES THAT THE FREQUENCY OF EXECUTION OF STATEMENTS - IS NOT TO BE LISTED NCT - SHORT FORM OF NOCOUNT DECK('DSNAME') - SPECIFIES THAT THE COMPILER IS TO PRODUCE AN OBJECT MODULE - IN CARD IMAGES ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE OBJECT MODULE. IF THE NAME IS OMITTED A NAME - IS GENERATED WITH THE QUALIFIER 'DECK' D('DSNAME') - SHORT FORM OF DECK NODECK - SPECIFIES THAT NO OBJECT MODULE IS PRODUCED ND - SHORT FORM OF NODECK DUMP - SPECIFIES THAT THE CONTENTS OF THE REGISTERS AND MAIN - STORAGE ARE TO BE LISTED IF THE COMPILER TERMINATES - ABNORMALLY PLI Page 106 PLI DU - SHORT FORM OF DUMP NODUMP - SPECIFIES THAT THE CONTENTS OF THE REGISTERS AND MAIN - STORAGE ARE NOT LISTED IF THE COMPILER TERMINATES - ABNORMALLY NDU - SHORT FORM OF NODUMP ESD - SPECIFIES THAT THE EXTERNAL SYMBOL DICTIONARY IS TO BE - LISTED NOESD - SPECIFIES THAT THE EXTERNAL SYMBOL DICTIONARY IS NOT - LISTED FLAG(I/W/E/S) - SPECIFIES THE MINIMUM MESSAGE SEVERITY THAT REQUIRES A - MESSAGE TO BE LISTED. - IF THE SEVERITY IS OMITTED, THEN FLAG(I) IS ASSUMED I - ALL MESSAGES ARE TO BE LISTED W - ALL MESSAGES EXCEPT INFORMATORY ARE TO BE LISTED E - ALL MESSAGES EXCEPT WARNING AND INFORMATORY TO BE LISTED S - ONLY SEVERE AND UNRECOVERABLE MESSAGES ARE TO BE LISTED F(I/W/E/S) - SHORT FORM OF FLAG FLOW('INTEGER1' 'INTEGER2') - SPECIFIES THAT THE NUMBERS OF THE STATEMENTS THAT CAUSE A - TRANSFER OF CONTROL IN THE SOURCE PROGRAM ARE TO BE LISTED - IF 'INTEGER1' AND 'INTEGER2' ARE NOT SPECIFIED, THEN THE - SYSGEN DEFAULTS ARE ASSUMED 'INTEGER1' - IS THE MAXIMUM NUMBER OF ENTRIES TO BE LISTED 'INTEGER2' - IS THE MAXIMUM NUMBER OF CHANGES OF BLOCKS TO BE RECORDED - IN THE LIST NOFLOW - SPECIFIES THAT THE NUMBER OF THE STATEMENTS THAT CAUSE A - TRANSFER OF CONTROL IN THE SOURCE PROGRAM ARE NOT LISTED PLI Page 107 PLI GONUMBER - SPECIFIES THAT LINE NUMBERS FROM THE SOURCE PROGRAM ARE TO - BE INCLUDED IN EXECUTION TIME MESSAGES. - USE OF GONUMBER IMPLIES NUMBER AND NOSTMT GN - SHORT FORM OF GONUMBER NOGONUMBER - SPECIFIES THAT THE LINE NUMBERS FROM THE ORIGINAL SOURCE - ARE NOT INCLUDED IN THE EXECUTION TIME MESSAGES NGN - SHORT FORM OF NOGONUMBER GOSTMT - SPECIFIES THAT STATEMENT NUMBERS FROM THE SOURCE PROGRAM - ARE TO BE INCLUDED IN THE EXECUTION TIME MESSAGES. - USE OF GOSTMT IMPLIES STMT AND NONUMBER GS - SHORT FORM OF GOSTMT NOGOSTMT - SPECIFIES THAT THE STATEMENT NUMBERS FROM THE ORIGINAL - SOURCE ARE NOT INCLUDED IN THE EXECTION TIME MESSAGES NGS - SHORT FORM OF NOGOSTMT IMPRECISE - SPECIFIES THAT EXTRA CODE IS TO BE EXECUTED TO LOCALISE - IMPRECISE INTERRUPTS WHEN EXECUTING THE COMPILED PROGRAM - ON MODELS 91 OR 195 IMP _ SHORT FORM OF IMPRECISE NOIMPRECISE - SPECIFIES THAT THE EXTRA CODE TO LOCALISE IMPRECISE - INTERRUPTS IS NOT INCLUDED IN THE COMPILED PROGRAM NIMP - SHORT FORM OF NOIMPRECISE INCLUDE- SPECIFIES THAT SECONDARY INPUT IS TO BE INCLUDED IN THE - SOURCE PROGRAM WITHOUT INVOKING THE MACRO PRE-PROCESSOR PLI Page 108 PLI INC - SHORT FORM OF INCLUDE NOINCLUDE - SPECIFIES THAT NO SECONDARY INPUT IS TO BE INCLUDED IN - THE SOURCE PROGRAM UNLESS THE MACRO OPTION IS SPECIFIED INSOURCE - SPECIFIES THAT THE SOURCE PROGRAM (INCLUDING PREPROCESSOR - STATEMENTS) IS TO BE LISTED IS - SHORT FORM OF INSOURCE NOINSOURCE - SPECIFIES THAT THE SOURCE PROGRAM (INCLUDING PREPROCESSOR - STATEMENTS) IS NOT TO BE LISTED NIS - SHORT FORM OF NOINSOURCE INTERRUPT - SPECIFIES THAT THE PROGRAM WILL HANDLE TERMINAL INTERRUPTS INT - SHORT FORM OF INTERRUPT NOINTERRUPT - SPECIFIES THAT THE PROGRAM WILL NOT HANDLE TERMINAL - INTERRUPTS NINT - SHORT FORM OF NOINTERRUPT LINECOUNT('INTEGER') - SPECIFIES THE NUMBER OF LINES TO BE PRODUCED ON EACH PAGE - OF THE COMPILER LISTING 'INTEGER' - IS THE NUMBER OF LINES ON EACH PAGE. VALID VALUES ARE 1 TO - TO 32767 LC('INTEGER') - SHORT FORM OF LINECOUNT PLI Page 109 PLI LIST('INTEGER1' 'INTEGER2') - SPECIES THAT THE OBJECT CODE GENERATED IS TO BE LISTED - IF SPECIFIED, 'INTEGER1' AND 'INTEGER2' MUST BE LINE - NUMBERS IF THE NUMBER OPTION APPLIES, OR STATEMENT NUMBERS - IF THE STATEMENT OPTION APPLIES 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE FIRST STATEMENT WHOSE OBJECT - CODE IS TO BE LISTED. IF OMITTED, THE WHOLE PROGRAM IS - LISTED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE LAST STATEMENT WHOSE OBJECT - CODE IS TO BE LISTED. IF OMITTED, ONLY STATEMENT - 'INTEGER1' IS LISTED NOLIST - SPECIFIES THAT THE OBJECT CODE GENERATED IS NOT LISTED LMESSAGE - SPECIFIES THAT THE COMPILER IS TO PRODUCE THE LONG FORM OF - ANY MESSAGES GENERATED LMSG - SHORT FORM OF LMESSAGE MACRO - SPECIFIES THAT THE SOURCE PROGRAM IS TO BE PROCESSED BY - THE PREPROCESSOR M - SHORT FORM OF MACRO NOMACRO- SPECIFIES THAT THE SOURCE PROGRAM IS NOT TO BE PROCESSED - BY THE PREPROCESSOR NM - SHORT FORM OF NOMACRO MAP - SPECIFIES THAT THE ORGANISATION OF THE STATIC STORAGE FOR - THE OBJECT MODULE IS TO BE LISTED NOMAP - SPECIFIES THAT THE ORGANISATION OF THE STATIC STORAGE FOR - THE OBJECT MODULE IS NOT TO BE LISTED MARGINI('CHARACTER') - SPECIFIES THE CHARACTER TO BE USED TO INDICATE THE LEFT - AND RIGHT HAND MARGINS OF THE SOURCE PROGRAM AS SPECIFIED - BY THE MARGIN OPTION PLI Page 110 PLI 'CHARACTER' - IS ANY CHARACTER IN QUOTES. IF THE CHARACTER IS A QUOTE, - IT MUST BE IN THE QUOTED CHARACTER STRING AS TWO QUOTES MI('CHARACTER') - SHORT FORM OF MARGINI NOMARGINI - SPECIFIES THAT NO CHARACTER IS TO BE USED TO INDICATE THE - MARGINS OF THE SOURCE PROGRAM NMI - SHORT FORM OF NOMARGINI MARGINS('INTEGER1' 'INTEGER2' 'INTEGER3') - SPECIFIES THE EXTENT OF THE PART OF EACH INPUT LINE OR - RECORD THAT CONTAINS PL/I STATEMENTS 'INTEGER1' - SPECIFIES THE LEFT HAND MARGIN 'INTEGER2' - SPECIFIES THE RIGHT HAND MARGIN 'INTEGER3' - IS OPTIONAL AND SPECIFIES THE POSITION OF THE ANS PRINTER - CONTROL CHARACTER MAR('INTEGER1' 'INTEGER2' 'INTEGER3') - SHORT FORM OF MARGINS MDECK('DSNAME') - SPECIFIES THAT THE PREPROCESSOR IS TO PRODUCE A COPY OF - ITS OUTPUT ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE PREPROCESSOR OUTPUT. IF THE NAME IS OMITTED, A - NAME IS GENERATED WITH THE QUALIFIER 'DECK' MD('DSNAME') - SHORT FORM OF MDECK NOMDECK- SPECIFIES THAT NO COPY OF THE PREPROCESSOR OUTPUT IS TO BE - PRODUCED MND - SHORT FORM OF NOMDECK PLI Page 111 PLI NAME('NAME') - SPECIFIES THAT THE COMPILER IS TO GENERATE A LINKAGE - EDITOR NAME STATEMENT AS THE LAST STATEMENT OF THE - OBJECT MODULE 'NAME' - IS ONE TO EIGHT CHARACTERS ENCLOSED IN QUOTES. THE FIRST - CHARACTER MUST BE ALPHABETIC N('NAME') - SHORT FORM OF NAME NEST - SPECIFIES THAT THE LISTING RESULTING FROM THE SOURCE - OPTION WILL INDICATE THE BEGIN-BLOCK LEVEL AND DO-GROUP - LEVEL OF EACH STATEMENT NONEST - SPECIFIES THAT THE LISTING RESULTING FROM THE SOURCE - OPTION WILL NOT INDICATE THE BEGIN-BLOCK LEVEL OR - DO-GROUP LEVEL OF EACH STATEMENT NUMBER - SPECIFIES THAT THE NUMBERS IN THE SEQUENCE FIELDS OF THE - SOURCE INPUT RECORDS ARE TO BE USED AS STATEMENT NUMBERS NUM - SHORT FORM OF NUMBER NONUMBER - SPECIFIES THAT THE NUMBERS IN THE SEQUENCE FIELDS OF THE - SOURCE INPUT RECORDS ARE NOT TO BE USED AS STATEMENT - NUMBERS. NONUMBER IMPLIES STMT NNUM - SHORT FORM OF NONUMBER OBJECT('DSNAME') - SPECIFIES THAT THE COMPILER IS TO PRODUCE AN OBJECT MODULE - IN CARD IMAGES ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE OBJECT MODULE. IF IT IS OMITTED, A NAME IS - GENERATED WITH THE QUALIFIER 'OBJ' OBJ('DSNAME') - SHORT FORM OF OBJECT NOOBJECT - SPECIFIES THAT NO OBJECT MODULE IS TO BE PRODUCED PLI Page 112 PLI NOBJ - SHORT FORM OF NOOBJECT OFFSET - SPECIFIES THAT A TABLE OF STATEMENT OR LINE NUMBERS WITH - THEIR OFFSET ADDRESSES RELATIVE TO THE PRIMARY ENTRY POINT - IS TO BE LISTED OF - SHORT FORM OF OFFSET NOOFFSET - SPECIFIES THAT THE TABLE OF STATEMENT OR LINE NUMBERS WITH - THEIR OFFSET ADDRESSES RELATIVE TO THE PRIMARY ENTRY POINT - IS NOT TO BE LISTED NOF - SHORT FORM OF NOOFFSET OPTIMIZE(0/2/TIME) - SPECIFIES THE TYPE OF OPTIMIZATION REQUIRED 0 - IS EQUIVALENT TO NOOPTIMIZE 2 - IS EQUIVALENT TO OPTIMIZE(TIME) TIME - SPECIFIES THAT THE COMPILER IS TO OPTIMIZE THE MACHINE - INSTRUCTIONS GENERATED FOR MINIMUM EXECUTION TIME OPT(0/2/TIME) - SHORT FORM OF OPTIMIZE NOOPTIMIZE - SPECIFIES MAXIMUM COMPILATION SPEED, BUT INHIBITS - OPTIMIZATION FOR FASTER EXECUTION NOPT - SHORT FORM OF NOOPTIMIZE OPTIONS- SPECIFIES THAT THE OPTIONS TO BE USED DURING THIS - COMPILATION ARE TO BE LISTED OP - SHORT FORM OF OPTIONS NOOPTIONS - SPECIFIES THAT THE OPTIONS TO BE USED DURING THIS - COMPILATION ARE NOT TO BE LISTED PLI Page 113 PLI NOP - SHORT FORM OF NOOPTIONS SEQUENCE('INTEGER1' 'INTEGER2') - SPECIFIES THE EXTENT OF THE PART OF EACH INPUT LINE OR - RECORD THAT CONTAINS A SEQUENCE NUMBER 'INTEGER1' - SPECIFIES THE LEFT HAND MARGIN OF THE SEQUENCE FIELD 'INTEGER2' - SPECIFIES THE RIGHT HAND MARGIN OF THE SEQUENCE FIELD SEQ('INTEGER1' 'INTEGER2') - SHORT FORM OF SEQUENCE NOSEQUENCE - SPECIFIES THAT THERE IS NO SEQUENCE NUMBER IN THE INPUT - LINE OR RECORD NSEQ - SHORT FORM OF NOSEQUENCE SIZE('INTEGER1'/'INTEGER2'K/-'INTEGER3'/-'INTEGER'K/MAX) - SPECIFIES THE AMOUNT OF MAIN STORAGE TO BE USED BY THE - COMPILER 'INTEGER1' - SPECIFIES THE NUMBER OF BYTES OF STORAGE 'INTEGER2'K - SPECIFIES THE NUMBER OF 1K BLOCKS OF MAIN STORAGE -'INTEGER3' - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSSIBLE AND THEN RELEASE 'INTEGER3' BYTES - BACK TO THE OPERATING SYSTEM -'INTEGER4'K - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSIBLE AND THEN RELEASE 'INTEGER3' NUMBER - 1K BLOCKS BACK TO THE OPERATING SYSTEM MAX - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSSIBLE SZ('INTEGER1'/'INTEGER2'K/-'INTEGER4'K/MAX) - SHORT FORM OF SIZE SMESSAGE - SPECIFIES THAT THE COMPILER IS TO PRODUCE THE SHORT FORM - OF ANY MESSAGES GENERATED PLI Page 114 PLI SMSG - SHORT FORM OF SMESSAGE SOURCE - SPECIFIES THAT THE SOURCE PROGRAM IS TO BE LISTED S - SHORT FORM OF SOURCE NOSOURCE - SPECIFIES THAT THE SOURCE PROGRAM IS NOT TO BE LISTED NS - SHORT FORM OF NOSOURCE STMT - SPECIFIES THAT THE STATEMENTS IN THE SOURCE PROGRAM ARE - TO BE COUNTED AND THAT THIS 'STATEMENT NUMBER' IS USED TO - IDENTIFY STATEMENTS IN THE VARIOUS LISTINGS AND ERROR - MESSAGES PRODUCED. - STMT IS IMPLIED BY NONUMBER OR GOSTMT NOSTMT - NUMBER IS IMPLIED. SEE THE NUMBER OPTION STORAGE- SPECIFIES THAT A TABLE GIVING THE MAIN STORAGE - REQUIREMENTS OF THE OBJECT MODULE IS TO BE LISTED STG - SHORT FORM OF STORAGE NOSTORAGE - SPECIFIES THAT THE TABLE GIVING THE MAIN STORAGE - REQUIREMENTS OF THE OBJECT MODULE IS NOT TO BE LISTED NSTG - SHORT FORM OF NOSTORAGE SYNTAX - SPECIFIES THAT THE COMPILER IS TO CHECK THE SYNTAX OF - THE STATEMENTS IN THE SOURCE PROGRAM SYN - SHORT FORM OF SYNTAX NOSYNTAX(W/E/S) - WITHOUT ARGUMENT, SPECIFIES THAT THE COMPILATION IS - TERMINATED BEFORE SYNTAX CHECKING PLI Page 115 PLI - WITH ARGUMENT, SPECIFIES THAT THE SYNTAX CHECKING IS - CONDITIONAL ON THE SEVERITY OF THE MESSAGES GENERATED BY - THE PREPROCESSOR W - NO SYNTAX CHECKING IF WARNING, ERROR, SEVERE OR - UNRECOVERABLE ERROR MESSAGES ARE ISSUED E - NO SYNTAX CHECKING IF ERROR, SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED S - NO SYNTAX CHECKING IF SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED NSYN(W/E/S) - SHORT FORM OF NOSYNTAX TERMINAL('OPTION-LIST') - WITHOUT ARGUMENT, SPECIFIES THAT ANY DIAGNOSTIC AND - INFORMATORY MESSAGES ARE TO BE PRINTED AT THE TERMINAL - WITH ARGUMENT, SPECIFIES THAT OTHER COMPILER LISTINGS - ARE PRINTED AT THE TERMINAL 'OPTION-LIST' - CAN BE ANY COMBINATION OF - AGGREGATE ATTRIBUTES ESD INSOURCE LIST MAP OPTIONS SOURCE STORAGE XREF TERM('OPTION-LIST') - SHORT FORM OF TERMINAL NOTERMINAL - SPECIFIES THAT NO LISTINGS OR MESSAGES ARE TO BE PRODUCED - AT THE TERMINAL NTERM - SHORT FORM OF NOTERMINAL XREF(FULL/SHORT) - SPECIFIES THAT ALL IDENTIFIERS TOGETHER WITH THE NUMBERS - OF THE STATEMENTS IN WHICH THEY ARE DECLARED OR REFERENCED - ARE TO BE LISTED. PLI Page 116 PLI - IF THE ARGUMENT IS OMITTED THE SYSGEN DEFAULT IS ASSUMED, - UNLESS THE ARGUMENT IS SPECIFIED FOR THE ATTRIBUTE OPERAND FULL - IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE INCLUDED IN THE LISTING SHORT- IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE OMITTED FROM THE LISTING X(F/S) - SHORT FORM OF XREF NOXREF - SPECIFIES THAT THE IDENTIFIERS TOGETHER WITH THE NUMBERS - OF THE STATEMENTS IN WHICH THEY ARE DECLARED OR REFERENCED - ARE NOT LISTED NX - SHORT FORM OF NOXREF COMMAND NAME - PLIHELP NO SUBCOMMANDS FUNCTION - THE PLI COMMAND IS USED TO INVOKE THE PL/1 OPTIMIZING COMPILER SYNTAX - PLI 'DSNAME' PRINT(*/'DSNAME' 'INTEGER1' 'INTEGER2')/NOPRINT/ SYSPRINT('CLASSNAME' 'INTEGER1' 'INTEGER2') LIB('DSLIST') AGGREGATE/NOAGGREGATE/AG/NAG ATTRIBUTES(FULL/SHORT)/NOATTRIBUTES/A(F/S)/NA CHARSET(48/60 EBCDIC/BCD)/CS(48/60 EB/B) COMPILE/NOCOMPILE(W/E/S)/C/NC(W/E/S) CONTROL('PASSWORD') COUNT/NOCOUNT/CT/NCT DECK('DSNAME')/NODECK/D('DSNAME')/ND DUMP/NODUMP/DU/NDU ESD/NOESD FLAG(I/W/E/S)/F(I/W/E/S) FLOW('INTEGER1' 'INTEGER2')/NOFLOW GRAPHIC/NOGRAPHIC PLIHELP Page 117 PLIHELP GONUMBER/NOGONUMBER/GN/NGN GOSTMT/NOGOSTMT/GS/NGS INCLUDE/NOINCLUDE/INC/NINC IMPRECISE/NOIMPRECISE/IMP/NIMP INSOURCE/NOINSOURCE/IS/NIS INTERRUPT/NOINTERRUPT/INT/NINT LINECOUNT('INTEGER')/LC('INTEGER') LIST('INTEGER1' 'INTEGER2')/NOLIST LMESSAGE/SMESSAGE/LMSG/SMSG MACRO/NOMACRO/M/NM MAP/NOMAP MARGINI('CHARACTER')/NOMARGINI/MI('CHARACTER')/NMI MARGINS('INTEGER1' 'INTEGER2' 'INTEGER3')/MAR('INTEGER1' 'INTEGER2' 'INTEGER3') MDECK('DSNAME')/NOMDECK/MD('DSNAME')/NMD NAME('NAME')/N('NAME') NEST/NONEST NUMBER/NONUMBER/NUM/NNUM OBJECT('DSNAME')/NOOBJECT/OBJ('DSNAME')/NOBJ OFFSET/NOOFFSET/OF/NOF OPTIMIZE(0/2/TIME)/NOOPTIMIZE/OPT(0/2/TIME)/NOPT OPTIONS/NOOPTIONS/OP/NOP SEQUENCE('INTEGER1' 'INTEGER2')/SEQ('INTEGER1' 'INTEGER2') NOSEQUENCE/NSEQ SIZE('INTEGER1'/'INTEGER2'K/-'INTEGER3'/-'INTEGER4'K/ MAX)/ SZ('INTEGER1'/'INTEGER2'K/-'INTEGER3'/ -'INTEGER4'K/MAX) SOURCE/NOSOURCE/S/NS STMT/NOSTMT STORAGE/NOSTORAGE/STG/NSTG SYNTAX/NOSYNTAX(W/E/S)/SYN/NSYN(W/E/S) TERMINAL('OPTION-LIST')/NOTERMINAL/TERM('OPTION-LIST')/ NTERM XREF(FULL/SHORT)/NOXREF/X(F/S)/NX OPERANDS - 'DSNAME' - THE NAME OF DATA SET TO BE COMPILED PRINT(*/'DSNAME' 'INTEGER1' 'INTEGER2') - SPECIFIES DESTINATION OF THE LISTING ON THE SYSPRINT FILE * - IS OPTIONAL AND SPECIFIES THAT THE LISTING ON THE SYSPRINT - FILE IS TO BE WRITTEN AT THE TERMINAL. NO OTHER COPY OF - THE FILE WILL BE AVAILABLE 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS - TO CONTAIN THE LISTING ON THE SYSPRINT FILE. IF IT IS - OMITTED, A NAME IS GENERATED WITH THE QUALIFIER 'LIST' PLIHELP Page 118 PLIHELP 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE PRIMARY - ALLOCATION FOR A NEW PRINT DATA-SET. THE PRIMARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER1' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE SECONDARY - ALLOCATION FOR A NEW PRINT DATA-SET. THE SECONDARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER2' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED NOPRINT- SPECIFIES THAT NO OUTPUT IS TO BE WRITTEN ON THE SYSPRINT - FILE SYSPRINT('CLASSNAME' 'INTEGER1' 'INTEGER2') - SPECIFIES THE LISTING OF THE SYSPRINT FILE IS TO BE PLACED - IN A SYSOUT CLASS 'CLASSNAME' - IS OPTIONAL AND IS THE NAME OF THE SYSOUT CLASS - WHICH IS TO CONTAIN THE LISTING OF THE SYSPRINT FILE. IF - IT IS OMITTED THE SYSGEN DEFAULT CLASS IS ASSUMED 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE PRIMARY - ALLOCATION FOR THE SYSOUT DATA-SET. THE PRIMARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER1' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE SIZE OF THE SECONDARY - ALLOCATION FOR THE SYSOUT DATA-SET. THE SECONDARY - ALLOCATION WILL BE SUFFICIENT TO CONTAIN 'INTEGER2' LINES - OF LISTING ON THE SYSPRINT FILE. IF IT IS OMITTED, THE - SYSGEN DEFAULT VALUE IS ASSUMED LIB('DSLIST') - SPECIFIES THE ONE OR MORE DATA SETS THAT ARE TO BE USED AS - THE SECONDARY INPUT TO THE PREPROCESSOR 'DSLIST' - IS THE DATA SET NAMES OF THE DATA SETS CONTAINING - THE SECONDARY INPUT. THE DATA SETS ARE CONCATENATED - IN THE ORDER SPECIFIED AGGREGATE - SPECIFIES THAT THE AGGREGATE LENGTH TABLE, GIVING THE - LENGTH OF ALL ARRAYS AND MAJOR STRUCTURES, IS TO BE LISTED PLIHELP Page 119 PLIHELP AG - SHORT FORM OF AGGREGATE NOAGGREGATE - SPECIFIES THAT THE AGGREGATE LENGTH TABLE, GIVING THE - LENGTH OF ALL ARRAYS AND MAJOR STRUCTURES, IS NOT TO BE - LISTED NAG - SHORT FORM OF NOAGGREGATE ATTRIBUTES(FULL/SHORT) - SPECIFIES THAT THE SOURCE PROGRAM IDENTIFIERS AND THEIR - DATA ATTRIBUTES ARE TO BE LISTED - IF THE ARGUMENT IS OMITTED THE SYSGEN DEFAULT IS ASSUMED, - UNLESS THE ARGUMENT IS SPECIFIED FOR THE XREF OPERAND FULL - IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE INCLUDED IN THE LISTING SHORT- IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE OMITTED FROM THE LISTING A(F/S) - SHORT FORM OF ATTRIBUTES NOATTRIBUTES - SPECIFIES THAT THE SOURCE PROGRAM IDENTIFIERS AND THEIR - DATA ATTRIBUTES ARE NOT TO BE LISTED NA - SHORT FORM OF NOATTRIBUTES CHARSET(48/60 EBCDIC/BCD) - SPECIFIES THE CHARACTER SET AND DATA CODE OF THE SOURCE - PROGRAM. BOTH ARGUMENTS ARE OPTIONAL AND THE SYSGEN - DEFAULT IS ASSUMED FOR AN OMITTED ARGUMENT 48 - THE SOURCE PROGRAM IS WRITTEN IN 48-CHARACTER SET 60 - THE SOURCE PROGRAM IS WRITTEN IN 60-CHARACTER SET EBCDIC - THE SOURCE PROGRAM IS WRITTEN IN EXTENDED BINARY CODED - DECIMAL INTERCHANGE CODE BCD - THE SOURCE PROGRAM IS WRITTEN IN BINARY CODED DECIMAL CODE CS(48/60 EB/B) - SHORT FORM OF CHARSET COMPILE- SPECIFIES THAT THE SOURCE PROGRAM IS TO BE COMPILED AFTER - SYNTAX CHECKING PLIHELP Page 120 PLIHELP C - SHORT FORM OF COMPILE NOCOMPILE(W/E/S) - WITHOUT ARGUMENT, SPECIFIES THAT THE COMPILATION IS - TERMINATED AFTER SYNTAX CHECKING. - WITH ARGUMENT, SPECIFIES THAT THE COMPILATION IS - CONDITIONAL ON THE SEVERITY OF THE MESSAGES GENERATED BY - THE PREPROCESSOR, OR DURING SYNTAX CHECKING W - NO COMPILATION IF WARNING, ERROR, SEVERE OR UNRECOVERABLE - ERROR MESSAGES ARE ISSUED E - NO COMPILATION IF ERROR, SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED S - NO COMPILATION IF SEVERE OR UNRECOVERABLE ERROR MESSAGES - ARE PRODUCED NC(W/E/S) - SHORT FORM OF NOCOMPILE CONTROL('PASSWORD') - SPECIFIES THAT ANY COMPILER OPTION DELETED FOR THE - INSTALLATION ARE AVAILABLE FOR THIS COMPILATION 'PASSWORD' - IS A CHARACTER STRING, NOT EXCEEDING EIGHT CHARACTERS COUNT - SPECIFIES THAT THE FREQUENCY OF EXECUTION OF STATEMENTS - IS TO BE LISTED CT - SHORT FORM OF COUNT NOCOUNT- SPECIFIES THAT THE FREQUENCY OF EXECUTION OF STATEMENTS - IS NOT TO BE LISTED NCT - SHORT FORM OF NOCOUNT DECK('DSNAME') - SPECIFIES THAT THE COMPILER IS TO PRODUCE AN OBJECT MODULE - IN CARD IMAGES ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE OBJECT MODULE. IF THE NAME IS OMITTED A NAME - IS GENERATED WITH THE QUALIFIER 'DECK' PLIHELP Page 121 PLIHELP D('DSNAME') - SHORT FORM OF DECK NODECK - SPECIFIES THAT NO OBJECT MODULE IS PRODUCED ND - SHORT FORM OF NODECK DUMP - SPECIFIES THAT THE CONTENTS OF THE REGISTERS AND MAIN - STORAGE ARE TO BE LISTED IF THE COMPILER TERMINATES - ABNORMALLY DU - SHORT FORM OF DUMP NODUMP - SPECIFIES THAT THE CONTENTS OF THE REGISTERS AND MAIN - STORAGE ARE NOT LISTED IF THE COMPILER TERMINATES - ABNORMALLY NDU - SHORT FORM OF NODUMP ESD - SPECIFIES THAT THE EXTERNAL SYMBOL DICTIONARY IS TO BE - LISTED NOESD - SPECIFIES THAT THE EXTERNAL SYMBOL DICTIONARY IS NOT - LISTED FLAG(I/W/E/S) - SPECIFIES THE MINIMUM MESSAGE SEVERITY THAT REQUIRES A - MESSAGE TO BE LISTED. - IF THE SEVERITY IS OMITTED, THEN FLAG(I) IS ASSUMED I - ALL MESSAGES ARE TO BE LISTED W - ALL MESSAGES EXCEPT INFORMATORY ARE TO BE LISTED E - ALL MESSAGES EXCEPT WARNING AND INFORMATORY TO BE LISTED S - ONLY SEVERE AND UNRECOVERABLE MESSAGES ARE TO BE LISTED F(I/W/E/S) - SHORT FORM OF FLAG FLOW('INTEGER1' 'INTEGER2') - SPECIFIES THAT THE NUMBERS OF THE STATEMENTS THAT CAUSE A PLIHELP Page 122 PLIHELP - TRANSFER OF CONTROL IN THE SOURCE PROGRAM ARE TO BE LISTED - IF 'INTEGER1' AND 'INTEGER2' ARE NOT SPECIFIED, THEN THE - SYSGEN DEFAULTS ARE ASSUMED 'INTEGER1' - IS THE MAXIMUM NUMBER OF ENTRIES TO BE LISTED 'INTEGER2' - IS THE MAXIMUM NUMBER OF CHANGES OF BLOCKS TO BE RECORDED - IN THE LIST NOFLOW - SPECIFIES THAT THE NUMBER OF THE STATEMENTS THAT CAUSE A - TRANSFER OF CONTROL IN THE SOURCE PROGRAM ARE NOT LISTED GRAPHIC - SPECIFIES THAT GRAPHIC STRING CONSTANTS OR COMMENTS APPEAR - WITHIN THE PROGRAM. NOGRAPHIC - SPECIFIES THAT GRAPHIC STRING CONSTANTS OR COMMENTS - DO NOT APPEAR WITHIN THE PROGRAM. GONUMBER - SPECIFIES THAT LINE NUMBERS FROM THE SOURCE PROGRAM ARE TO - BE INCLUDED IN EXECUTION TIME MESSAGES. - USE OF GONUMBER IMPLIES NUMBER AND NOSTMT GN - SHORT FORM OF GONUMBER NOGONUMBER - SPECIFIES THAT THE LINE NUMBERS FROM THE ORIGINAL SOURCE - ARE NOT INCLUDED IN THE EXECUTION TIME MESSAGES NGN - SHORT FORM OF NOGONUMBER GOSTMT - SPECIFIES THAT STATEMENT NUMBERS FROM THE SOURCE PROGRAM - ARE TO BE INCLUDED IN THE EXECUTION TIME MESSAGES. - USE OF GOSTMT IMPLIES STMT, NONUMBER, AND NOGONUMBER GS - SHORT FORM OF GOSTMT NOGOSTMT - SPECIFIES THAT THE STATEMENT NUMBERS FROM THE ORIGINAL - SOURCE ARE NOT INCLUDED IN THE EXECUTION TIME MESSAGES PLIHELP Page 123 PLIHELP NGS - SHORT FORM OF NOGOSTMT IMPRECISE - SPECIFIES THAT EXTRA CODE IS TO BE EXECUTED TO LOCALIZE - IMPRECISE INTERRUPTS WHEN EXECUTING THE COMPILED PROGRAM - ON MODELS 91, 165, OR 195 IMP - SHORT FORM OF IMPRECISE NOIMPRECISE - SPECIFIES THAT THE EXTRA CODE TO LOCALIZE IMPRECISE - INTERRUPTS IS NOT INCLUDED IN THE COMPILED PROGRAM NIMP - SHORT FORM OF NOIMPRECISE INCLUDE- SPECIFIES THAT SECONDARY INPUT IS TO BE INCLUDED IN THE - SOURCE PROGRAM WITHOUT INVOKING THE MACRO PRE-PROCESSOR INC - SHORT FORM OF INCLUDE NOINCLUDE - SPECIFIES THAT NO SECONDARY INPUT IS TO BE INCLUDED IN - THE SOURCE PROGRAM UNLESS THE MACRO OPTION IS SPECIFIED INSOURCE - SPECIFIES THAT THE SOURCE PROGRAM (INCLUDING PREPROCESSOR - STATEMENTS) IS TO BE LISTED IS - SHORT FORM OF INSOURCE NOINSOURCE - SPECIFIES THAT THE SOURCE PROGRAM (INCLUDING PREPROCESSOR - STATEMENTS) IS NOT TO BE LISTED NIS - SHORT FORM OF NOINSOURCE INTERRUPT - SPECIFIES THAT THE PROGRAM WILL HANDLE TERMINAL INTERRUPTS PLIHELP Page 124 PLIHELP INT - SHORT FORM OF INTERRUPT NOINTERRUPT - SPECIFIES THAT THE PROGRAM WILL NOT HANDLE TERMINAL - INTERRUPTS NINT - SHORT FORM OF NOINTERRUPT LINECOUNT('INTEGER') - SPECIFIES THE NUMBER OF LINES TO BE PRODUCED ON EACH PAGE - OF THE COMPILER LISTING 'INTEGER' - IS THE NUMBER OF LINES ON EACH PAGE. VALID VALUES ARE 1 TO - TO 32767 LC('INTEGER') - SHORT FORM OF LINECOUNT LIST('INTEGER1' 'INTEGER2') - SPECIES THAT THE OBJECT CODE GENERATED IS TO BE LISTED - IF SPECIFIED, 'INTEGER1' AND 'INTEGER2' MUST BE LINE - NUMBERS IF THE NUMBER OPTION APPLIES, OR STATEMENT NUMBERS - IF THE STATEMENT OPTION APPLIES 'INTEGER1' - IS OPTIONAL AND SPECIFIES THE FIRST STATEMENT WHOSE OBJECT - CODE IS TO BE LISTED. IF OMITTED, THE WHOLE PROGRAM IS - LISTED 'INTEGER2' - IS OPTIONAL AND SPECIFIES THE LAST STATEMENT WHOSE OBJECT - CODE IS TO BE LISTED. IF OMITTED, ONLY STATEMENT - 'INTEGER1' IS LISTED NOLIST - SPECIFIES THAT THE OBJECT CODE GENERATED IS NOT LISTED LMESSAGE - SPECIFIES THAT THE COMPILER IS TO PRODUCE THE LONG FORM OF - ANY MESSAGES GENERATED LMSG - SHORT FORM OF LMESSAGE MACRO - SPECIFIES THAT THE SOURCE PROGRAM IS TO BE PROCESSED BY - THE PREPROCESSOR PLIHELP Page 125 PLIHELP M - SHORT FORM OF MACRO NOMACRO- SPECIFIES THAT THE SOURCE PROGRAM IS NOT TO BE PROCESSED - BY THE PREPROCESSOR NM - SHORT FORM OF NOMACRO MAP - SPECIFIES THAT THE ORGANIZATION OF THE STATIC STORAGE FOR - THE OBJECT MODULE IS TO BE LISTED NOMAP - SPECIFIES THAT THE ORGANIZATION OF THE STATIC STORAGE FOR - THE OBJECT MODULE IS NOT TO BE LISTED MARGINI('CHARACTER') - SPECIFIES THE CHARACTER TO BE USED TO INDICATE THE LEFT - AND RIGHT HAND MARGINS OF THE SOURCE PROGRAM AS SPECIFIED - BY THE MARGIN OPTION 'CHARACTER' - IS ANY CHARACTER IN QUOTES. IF THE CHARACTER IS A QUOTE, - IT MUST BE IN THE QUOTED CHARACTER STRING AS TWO QUOTES MI('CHARACTER') - SHORT FORM OF MARGINI NOMARGINI - SPECIFIES THAT NO CHARACTER IS TO BE USED TO INDICATE THE - MARGINS OF THE SOURCE PROGRAM NMI - SHORT FORM OF NOMARGINI MARGINS('INTEGER1' 'INTEGER2' 'INTEGER3') - SPECIFIES THE EXTENT OF THE PART OF EACH INPUT LINE OR - RECORD THAT CONTAINS PL/I STATEMENTS 'INTEGER1' - SPECIFIES THE LEFT HAND MARGIN 'INTEGER2' - SPECIFIES THE RIGHT HAND MARGIN 'INTEGER3' - IS OPTIONAL AND SPECIFIES THE POSITION OF THE ANS PRINTER - CONTROL CHARACTER PLIHELP Page 126 PLIHELP MAR('INTEGER1' 'INTEGER2' 'INTEGER3') - SHORT FORM OF MARGINS MDECK('DSNAME') - SPECIFIES THAT THE PREPROCESSOR IS TO PRODUCE A COPY OF - ITS OUTPUT ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE PREPROCESSOR OUTPUT. IF THE NAME IS OMITTED, A - NAME IS GENERATED WITH THE QUALIFIER 'DECK' MD('DSNAME') - SHORT FORM OF MDECK NOMDECK- SPECIFIES THAT NO COPY OF THE PREPROCESSOR OUTPUT IS TO BE - PRODUCED MND - SHORT FORM OF NOMDECK NAME('NAME') - SPECIFIES THAT THE COMPILER IS TO GENERATE A LINKAGE - EDITOR NAME STATEMENT AS THE LAST STATEMENT OF THE - OBJECT MODULE 'NAME' - IS ONE TO EIGHT CHARACTERS ENCLOSED IN QUOTES. THE FIRST - CHARACTER MUST BE ALPHABETIC N('NAME') - SHORT FORM OF NAME NEST - SPECIFIES THAT THE LISTING RESULTING FROM THE SOURCE - OPTION WILL INDICATE THE BEGIN-BLOCK LEVEL AND DO-GROUP - LEVEL OF EACH STATEMENT NONEST - SPECIFIES THAT THE LISTING RESULTING FROM THE SOURCE - OPTION WILL NOT INDICATE THE BEGIN-BLOCK LEVEL OR - DO-GROUP LEVEL OF EACH STATEMENT NUMBER - SPECIFIES THAT THE NUMBERS IN THE SEQUENCE FIELDS OF THE - SOURCE INPUT RECORDS ARE TO BE USED AS STATEMENT NUMBERS NUM - SHORT FORM OF NUMBER PLIHELP Page 127 PLIHELP NONUMBER - SPECIFIES THAT THE NUMBERS IN THE SEQUENCE FIELDS OF THE - SOURCE INPUT RECORDS ARE NOT TO BE USED AS STATEMENT - NUMBERS. NONUMBER IMPLIES STMT NNUM - SHORT FORM OF NONUMBER OBJECT('DSNAME') - SPECIFIES THAT THE COMPILER IS TO PRODUCE AN OBJECT MODULE - IN CARD IMAGES ON THE DATA SET SPECIFIED 'DSNAME' - IS OPTIONAL AND IS THE NAME OF THE DATA SET WHICH IS TO - CONTAIN THE OBJECT MODULE. IF IT IS OMITTED, A NAME IS - GENERATED WITH THE QUALIFIER 'OBJ' OBJ('DSNAME') - SHORT FORM OF OBJECT NOOBJECT - SPECIFIES THAT NO OBJECT MODULE IS TO BE PRODUCED NOBJ - SHORT FORM OF NOOBJECT OFFSET - SPECIFIES THAT A TABLE OF STATEMENT OR LINE NUMBERS WITH - THEIR OFFSET ADDRESSES RELATIVE TO THE PRIMARY ENTRY POINT - IS TO BE LISTED OF - SHORT FORM OF OFFSET NOOFFSET - SPECIFIES THAT THE TABLE OF STATEMENT OR LINE NUMBERS WITH - THEIR OFFSET ADDRESSES RELATIVE TO THE PRIMARY ENTRY POINT - IS NOT TO BE LISTED NOF - SHORT FORM OF NOOFFSET OPTIMIZE(0/2/TIME) - SPECIFIES THE TYPE OF OPTIMIZATION REQUIRED 0 - IS EQUIVALENT TO NOOPTIMIZE 2 - IS EQUIVALENT TO OPTIMIZE(TIME) TIME - SPECIFIES THAT THE COMPILER IS TO OPTIMIZE THE MACHINE - INSTRUCTIONS GENERATED FOR MINIMUM EXECUTION TIME PLIHELP Page 128 PLIHELP OPT(0/2/TIME) - SHORT FORM OF OPTIMIZE NOOPTIMIZE - SPECIFIES MAXIMUM COMPILATION SPEED, BUT INHIBITS - OPTIMIZATION FOR FASTER EXECUTION NOPT - SHORT FORM OF NOOPTIMIZE OPTIONS- SPECIFIES THAT THE OPTIONS TO BE USED DURING THIS - COMPILATION ARE TO BE LISTED OP - SHORT FORM OF OPTIONS NOOPTIONS - SPECIFIES THAT THE OPTIONS TO BE USED DURING THIS - COMPILATION ARE NOT TO BE LISTED NOP - SHORT FORM OF NOOPTIONS SEQUENCE('INTEGER1' 'INTEGER2') - SPECIFIES THE EXTENT OF THE PART OF EACH INPUT LINE OR - RECORD THAT CONTAINS A SEQUENCE NUMBER 'INTEGER1' - SPECIFIES THE LEFT HAND MARGIN OF THE SEQUENCE FIELD 'INTEGER2' - SPECIFIES THE RIGHT HAND MARGIN OF THE SEQUENCE FIELD SEQ('INTEGER1' 'INTEGER2') - SHORT FORM OF SEQUENCE NOSEQUENCE - SPECIFIES THAT THERE IS NO SEQUENCE NUMBER IN THE INPUT - LINE OR RECORD NSEQ - SHORT FORM OF NOSEQUENCE SIZE('INTEGER1'/'INTEGER2'K/-'INTEGER3'/-'INTEGER'K/MAX) - SPECIFIES THE AMOUNT OF MAIN STORAGE TO BE USED BY THE - COMPILER PLIHELP Page 129 PLIHELP 'INTEGER1' - SPECIFIES THE NUMBER OF BYTES OF STORAGE 'INTEGER2'K - SPECIFIES THE NUMBER OF 1K BLOCKS OF MAIN STORAGE -'INTEGER3' - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSSIBLE AND THEN RELEASE 'INTEGER3' BYTES - BACK TO THE OPERATING SYSTEM -'INTEGER4'K - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSIBLE AND THEN RELEASE 'INTEGER3' NUMBER - 1K BLOCKS BACK TO THE OPERATING SYSTEM MAX - SPECIFIES THAT THE COMPILER IS TO OBTAIN AS MUCH MAIN - STORAGE AS POSSIBLE SZ('INTEGER1'/'INTEGER2'K/-'INTEGER4'K/MAX) - SHORT FORM OF SIZE SMESSAGE - SPECIFIES THAT THE COMPILER IS TO PRODUCE THE SHORT FORM - OF ANY MESSAGES GENERATED SMSG - SHORT FORM OF SMESSAGE SOURCE - SPECIFIES THAT THE SOURCE PROGRAM IS TO BE LISTED S - SHORT FORM OF SOURCE NOSOURCE - SPECIFIES THAT THE SOURCE PROGRAM IS NOT TO BE LISTED NS - SHORT FORM OF NOSOURCE STMT - SPECIFIES THAT THE STATEMENTS IN THE SOURCE PROGRAM ARE - TO BE COUNTED AND THAT THIS 'STATEMENT NUMBER' IS USED TO - IDENTIFY STATEMENTS IN THE VARIOUS LISTINGS AND ERROR - MESSAGES PRODUCED. - STMT IS IMPLIED BY NONUMBER OR GOSTMT NOSTMT - NUMBER IS IMPLIED. SEE THE NUMBER OPTION STORAGE- SPECIFIES THAT A TABLE GIVING THE MAIN STORAGE - REQUIREMENTS OF THE OBJECT MODULE IS TO BE LISTED PLIHELP Page 130 PLIHELP STG - SHORT FORM OF STORAGE NOSTORAGE - SPECIFIES THAT THE TABLE GIVING THE MAIN STORAGE - REQUIREMENTS OF THE OBJECT MODULE IS NOT TO BE LISTED NSTG - SHORT FORM OF NOSTORAGE SYNTAX - SPECIFIES THAT THE COMPILER IS TO CHECK THE SYNTAX OF - THE STATEMENTS IN THE SOURCE PROGRAM SYN - SHORT FORM OF SYNTAX NOSYNTAX(W/E/S) - WITHOUT ARGUMENT, SPECIFIES THAT THE COMPILATION IS - TERMINATED BEFORE SYNTAX CHECKING - WITH ARGUMENT, SPECIFIES THAT THE SYNTAX CHECKING IS - CONDITIONAL ON THE SEVERITY OF THE MESSAGES GENERATED BY - THE PREPROCESSOR W - NO SYNTAX CHECKING IF WARNING, ERROR, SEVERE OR - UNRECOVERABLE ERROR MESSAGES ARE ISSUED E - NO SYNTAX CHECKING IF ERROR, SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED S - NO SYNTAX CHECKING IF SEVERE OR UNRECOVERABLE ERROR - MESSAGES ARE ISSUED NSYN(W/E/S) - SHORT FORM OF NOSYNTAX TERMINAL('OPTION-LIST') - WITHOUT ARGUMENT, SPECIFIES THAT ANY DIAGNOSTIC AND - INFORMATORY MESSAGES ARE TO BE PRINTED AT THE TERMINAL - WITH ARGUMENT, SPECIFIES THAT OTHER COMPILER LISTINGS - ARE PRINTED AT THE TERMINAL 'OPTION-LIST' - CAN BE ANY COMBINATION OF - AGGREGATE ATTRIBUTES ESD INSOURCE LIST MAP OPTIONS PLIHELP Page 131 PLIHELP SOURCE STORAGE XREF TERM('OPTION-LIST') - SHORT FORM OF TERMINAL NOTERMINAL - SPECIFIES THAT NO LISTINGS OR MESSAGES ARE TO BE PRODUCED - AT THE TERMINAL NTERM - SHORT FORM OF NOTERMINAL XREF(FULL/SHORT) - SPECIFIES THAT ALL IDENTIFIERS TOGETHER WITH THE NUMBERS - OF THE STATEMENTS IN WHICH THEY ARE DECLARED OR REFERENCED - ARE TO BE LISTED. - IF THE ARGUMENT IS OMITTED THE SYSGEN DEFAULT IS ASSUMED, - UNLESS THE ARGUMENT IS SPECIFIED FOR THE ATTRIBUTE OPERAND FULL - IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE INCLUDED IN THE LISTING SHORT- IS OPTIONAL AND SPECIFIES THAT UNREFERENCED IDENTIFIERS - ARE TO BE OMITTED FROM THE LISTING X(F/S) - SHORT FORM OF XREF NOXREF - SPECIFIES THAT THE IDENTIFIERS TOGETHER WITH THE NUMBERS - OF THE STATEMENTS IN WHICH THEY ARE DECLARED OR REFERENCED - ARE NOT LISTED NX - SHORT FORM OF NOXREF COMMAND NAME - PRESS FUNCTION - THE PRESS COMMAND IS USED TO CREATE A WYLBUR COMPRESSED FORMAT DATASET FROM A TSO OR OS FORMATTED DATASET. PRESS Page 132 PRESS SYNTAX - PRESS 'TSO-DSNAME' 'WYL-DSNAME' CARD VAR TXTF PRINT PLI ASA SEQUENCED('A/B') IBM SKIP('N') TAKE('N') LIST NOPRINT CODE('WORD') OPTIONS('LIST') REQUIRED - 'TSO-DSNAME' 'WYL-DSNAME' DEFAULTS - CARD IBM SEQUENCED(73/80) OPERANDS 'TSO-DSNAME' - THE NAME OF THE INPUT DATASET. 'WYL-DSNAME' - THE NAME OF THE OUTPUT DATASET. CARD - THE INPUT DATASET IS OF THE FORMAT: RECFM(F B) LRECL(80) VAR - THE INPUT DATASET IS OF THE FORMAT: RECFM(V B) LRECL(255) TXTF - THE INPUT DATASET HAS STANDARD IBM TEXT FORMAT. PRINT - THE INPUT IS IF THE FORMAT: LRECL(133) PLI - THE INPUT HAS STANDARD IBM PLI FORMAT. ASA - THE INPUT HAS ANSI PRINTER CONTROL CHARACTERS. SEQUENCED('A/B') - THE INPUT IS SEQUENCED IN COLUMNS A THRU B. THE SEQUENCE NUMBERS ARE CONVERTED TO BLANKS IN THE OUTPUT DATASET. IBM - THE INPUT DATASET HAS IBM STYLE NUMBERS RATHER THAN WYLBUR. SKIP('N') - SKIP 'N' LINE OF THE INPUT DATASET. TAKE('N') - PRESS 'N' LINES OF THE INPUT DATASET. LIST - LIST THE INPUT DATASET LINES ON THE TERMINAL. PRESS Page 133 PRESS NOPRINT - SUPRESS WYLBUR INFORMATORY HEADINGS FROM BEING PRINTED. CODE('WORD') - THE OUTPUT DATASET IS TO BE SCRAMBLED ON KEY 'WORD' OPTIONS('LIST') - OLD WAY TO PASS PARAMETERS TO PRESS. COMMAND NAME - PRINT FUNCTION - THE PRINT COMMAND IS USED TO LIST PART OR ALL OF AN INDEXED- SEQUENTIAL, SEQUENTIAL, OR VSAM DATA SET. SYNTAX - PRINT INFILE('DNAME/PASSWORD') | INDATASET('ENTRYNAME/PASSWORD') OUTFILE('DNAME') FROMKEY('KEY') | FROMADDRESS('ADDRESS') | FROMNUMBER('NUMBER') | SKIP('COUNT') TOKEY('KEY') | TOADDRESS('ADDRESS') | TONUMBER('NUMBER') | COUNT('COUNT') HEX | CHARACTER | DUMP REQUIRED - INFILE | INDATASET DEFAULT- DUMP ABBREVIATIONS - NOTE - IN ADDITION TO NORMAL TSO SHORT FORMS, THESE ARE ACCEPTED. INFILE IFILE INDATASET IDS OUTFILE OFILE FROMKEY FKEY FROMADDRESS FADDR FROMNUMBER FNUM TOADDRESS TADDR TONUMBER TNUM OPERANDS - INFILE('DNAME/PASSWORD') - SPECIFIES THE NAME OF THE DD STATEMENT THAT IDENTIFIES THE DATA SET OR COMPONENT TO BE PRINTED. 'DNAME'- NAME OF THE DD STATEMENT THAT IDENTIFIES THE DATA SET PRINT Page 134 PRINT OR COMPONTENT TO BE PRINTED. 'PASSWORD' - PASSWORD OF DATA SET OR COMPONENT TO BE PRINTED. REQUIRED - 'DNAME' INDATASET('ENTRYNAME/PASSWORD') - SPECIFIES THE NAME OF THE ENTRY TO BE PRINTED. 'ENTRYNAME' - NAME OF THE ENTRY TO BE PRINTED. 'PASSWORD' - PASSWORD OF THE ENTRY TO BE PRINTED. REQUIRED - 'ENTRYNAME' OUTFILE('DNAME') - SPECIFIES THE NAME OF A DD STATEMENT THAT IDENTIFIES AN OUTPUT DATA SET OTHER THAN SYSPRINT. 'DNAME'- NAME OF A DD STATEMENT THAT IDENTIFIES AN ALTERNATE OUTPUT DATA SET. FROMKEY('KEY') - SPECIFIES THE KEY OF THE FIRST RECORD TO BE PRINTED. 'KEY'- KEY OF THE FIRST RECORD TO BE PRINTED. FROMADDRESS('ADDRESS') - SPECIFIES THE RELATIVE BYTE ADDRESS OF THE FIRST RECORD TO BE PRINTED. 'ADDRESS' - RELATIVE BYTE ADDRESS OF THE FIRST RECORD TO BE PRINTED. FROMNUMBER('NUMBER') - SPECIFIES THE RELATIVE RECORD NUMBER OF THE FIRST RECORD TO BE PRINTED. 'NUMBER' - RELATIVE RECORD NUMBER OF THE FIRST RECORD TO BE PRINTED. SKIP('COUNT') - SPECIFIES THE NUMBER OF LOGICAL RECORDS TO BE SKIPPED BEFORE THE PRINTING BEGINS. 'COUNT'- NUMBER OF LOGICAL RECORDS TO BE SKIPPED BEFORE PRINTING. TOKEY('KEY') - SPECIFIES THE KEY OF THE LAST RECORD TO BE PRINTED. 'KEY'- KEY OF THE LAST RECORD TO BE PRINTED. PRINT Page 135 PRINT TOADDRESS('ADDRESS') - SPECIFIES THE RELATIVE BYTE ADDRESS OF THE LAST RECORD TO BE PRINTED. 'ADDRESS' - RELATIVE BYTE ADDRESS OF THE LAST RECORD TO BE PRINTED. TONUMBER('NUMBER') - SPECIFIES THE RELATIVE RECORD NUMBER OF THE LAST RECORD TO BE PRINTED. 'NUMBER' - RELATIVE RECORD NUMBER OF THE LAST RECORD TO BE PRINTED. COUNT('COUNT') - SPECIFIES THE NUMBER OF LOGICAL RECORDS TO BE PRINTED. 'COUNT'- NUMBER OF LOGICAL RECORDS TO BE PRINTED. HEX - SPECIFIES THAT EACH BYTE IN THE LOGICAL RECORD TO TO BE PRINTED AS TWO HEXADECIMAL DIGITS. CHARACTER - SPECIFIES THAT EACH BYTE IN THE LOGICAL RECORD IS TO BE PRINTED AS A CHARACTER. DUMP - SPECIFIES THAT EACH BYTE IN THE LOGICAL RECORD IS TO BE PRINTED IN BOTH HEXADECIMAL AND CHARACTER FORMAT. COMMAND NAME - PRINTDOC Function - The PRINTDOC command is used to route a print image data set to the Xerox 8700 Laser Document Printer. Syntax - PRINTDOC 'input-dataset' COPIES('#copies') TYPE('font') ENHANCED DUPLEX OVERLAY('form') FORMS('form#') PAPER(ALT/ALTPRI) Required - 'input-dataset' Defaults - COPIES(1) TYPE(PELI) Note - Users should use the forms operand only after having made PRINTDOC Page 136 PRINTDOC arrangements with the Operations Manager. THE PRINTDOC command assumes there are carriage control characters in column 1. Operands - 'input-dataset' - The print image data set to be printed. COPIES('#copies') - Specifies the number of copies to be produced. TYPE('font') - The type of font to be printed. The type fonts currently available are: PELI (default) Prestige Elite 12 cpi, portrait ARTI Artisan Elite 12 cpi, portrait PICA Titan Pica 10 cpi, portrait COUR Seriffed Courier 10 cpi, portrait DATA Sans-Serif 13.6 cpi, landscape (Portrait fonts print along the 8 1/2" side of the page, while landscape fonts print along the 11" side of the page). ENHANCED - If you use hex 09 and hex 38 for sub- and superscripts, use the ENHANCED option of PRINTDOC, which is available from CMS or TSO (not MVS WYLBUR). Sub- and superscripts can be printed only in the portrait fonts. DUPLEX - Allows printing on both faces of a sheet of paper and is charged as two pages. OVERLAY('name') - 'name' is the four character code for a predefined departmental letterhead which is printed below the 'University of Illinois' letterhead. Before using OVERLAY, users should contact the Operations Manager to define a departmental letterhead. FORMS('form#') - Specifies the form number the output should be routed to. PAPER(ALT) - specified if you are using special forms or an OVERLAY on letterhead paper and want all your output printed on them. PAPER(ALTPRI) - specified if you are using special forms or an OVERLAY on letterhead paper and want only the first page of each copy printed on the special form. PRINTOFF Page 137 PRINTOFF COMMAND NAME - PRINTOFF FUNCTION - THE PRINTOFF COMMAND CAN BE USED TO OBTAIN HARDCOPY OF DATA SETS THROUGH FOREGROUND COPYING TO SYSOUT. THE COMMAND PRINTS A DATASET(S) WHICH IS SEQUENTIAL OR PARTITIONED, BLOCKED OR UNBLOCKED, WITH FIXED OR VARIABLE RECORD LENGTH LESS THAN OR EQUAL TO 256 (255 IF WITHOUT CARRIAGE CONTROL). SYNTAX - PRINTOFF ('DSLIST') CLASS('CLASS') DEST('USERID') COPIES('NNN') HOLD/NOHOLD LIST/NOLIST PRINT/NOPRINT REQUIRED -- 'DSLIST' ALIAS -- PRINTO DEFAULTS -- CLASS(A), COPIES(1), NOHOLD, LIST, PRINT OPERANDS - 'DSLIST' - 'DATA SET LIST' CONTAINS THE NAMES OF DATA SETS TO BE PRINTED OR PUNCHED. THE NAMES SHOULD FOLLOW TSO CONVENTION, IN QUOTES IF THE PRIMARY INDEX DIFFERS FROM YOUR USERID, OR WITHOUT QUOTES AND WITH THE PRIMARY INDEX OMITTED IF IT IS THE SAME AS YOUR USERID. CLASS('CLASS') - SYSOUT CLASS IN WHICH OUTPUT IS TO BE PRINTED. DEFAULT IS A. COPIES('NNN') - NUMBER OF COPIES TO BE PRINTED. DEFAULT IS 1. DEST('USERID') - REMOTE USER TO WHICH SYSOUT DATA SETS ARE TO BE ROUTED. HOLD - OUTPUT IS TO BE PLACED ON A HOLD QUEUE UPON DEALLOCATION. PRINTOFF Page 138 PRINTOFF NOHOLD- OUTPUT IS NOT TO BE PLACED ON A HOLD QUEUE UPON DEALLOCATION. LIST - MEMBER NAMES ARE ONLY TO BE LISTED UNLESS PRINT IS EXPLICITLY STATED. NOLIST - MEMBER NAMES ARE NOT TO BE LISTED (ONLY PRINTED UNLESS NOPRINT IS EXPLICITLY STATED). PRINT - MEMBERS ARE ONLY TO BE PRINTED (NOT LISTED UNLESS LIST IS EXPLICITLY STATED). NOPRINT - MEMBERS ARE NOT TO BE PRINTED (ONLY LISTED UNLESS NOLIST IS EXPLICITLY STATED). COMMAND NAME - PROCHELP FUNCTION - THE PROCHELP COMMAND IS USED TO LIST SYSTEM JCL PROCEDURES AS AN AID IN THEIR USE. SYNTAX - PROCHELP 'PROCNAME' SYSPRINT REQUIRED - NONE DEFAULTS - IF 'PROCNAME' IS NOT ENTERED IT DEFAULTS TO 'NAMES' WHICH WILL PRODUCE A LISTING OF AVAILABLE PROCEDURES FOUND IN 'UICCAPP.PROCLIB(NAMES)'. THE LISTING DEFAULTS TO THE TERMINAL. NOTE - 'PROCNAME' MAY OPTIONALLY BE ENTERED AS A SUBFIELD OF THE KEYWORD 'NAME'. EXAMPLE: PROCHELP NAME('PROCNAME') OPERANDS - PROCNAME - THE NAME OF THE REQUESTED PROCEDURE. PROCHELP Page 139 PROCHELP SYSPRINT - IF ENTERED, THE LISTING IS PRINTED OFFLINE. NAME('PROCNAME') - ALTERNATIVE SPECIFICATION OF 'PROCNAME' COMMAND NAME - PROFILE FUNCTION - THE PROFILE COMMAND IS USED EITHER TO SPECIFY TO THE SYSTEM CERTAIN USER CHARACTERISTICS WHICH ARE TO BE USED TO CONTROL THE FLOW OF INFORMATION TO AND FROM THE TERMINAL OR TO LIST THE USER PROFILE. THE USER PROFILE IS RETAINED THROUGHOUT EACH TERMINAL SESSION UNLESS THE USER WISHES TO CHANGE IT BY ISSUING THE PROFILE COMMAND AGAIN AND SPECIFYING THE APPROPRIATE OPERANDS. CHANGES MADE WHILE PROCESSING IN THE BACKGROUND WILL NOT BE SAVED AND YOUR FOREGROUND PROFILE WILL NOT BE AFFECTED. SYNTAX- PROFILE LINE('CHARACTER')/LINE(ATTN)/LINE(CTLX)/NOLINE CHAR('CHARACTER')/CHAR(BS)/NOCHAR PROMPT/NOPROMPT INTERCOM/NOINTERCOM PAUSE/NOPAUSE MSGID/NOMSGID MODE/NOMODE WTPMSG/NOWTPMSG PREFIX('PREFIX')/NOPREFIX LIST RECOVER/NORECOVER REQUIRED - NONE DEFAULTS - FOR PREFIX THE DEFAULT IS THE LOGON USERID - IF THE COMMAND IS ENTERED WITH NO OPERANDS, THE DEFAULT IS LIST ALIAS- PROF OPERANDS- LINE('CHARACTER') - SPECIFIES THE CHARACTER WHICH IS TO BE USED FOR DELETING A LINE. 'CHARACTER' - IS ANY VALID CHARACTER. LINE(ATTN) - SPECIFIES THAT ATTENTION IS TO BE USED TO DELETE A LINE. PROFILE Page 140 PROFILE THIS IS THE SYSTEM DEFAULT DELETE CHARACTER FOR THE KEYBOARD TYPE TERMINAL. LINE(CTLX) - SPECIFIES THAT CTLX IS TO BE USED TO DELETE A LINE FOR THE TELETYPE TERMINAL. THIS IS THE SYSTEM DEFAULT DELETE CHARACTER FOR THE TELETYPE TERMINAL. NOLINE - SPECIFIES THAT THERE IS TO BE NO LINE DELETING CHARACTER. CHAR('CHARACTER') - SPECIFIES THE CHARACTER TO BE USED TO DELETE A CHARACTER. 'CHARACTER' - IS ANY VALID CHARACTER. CHAR(BS) - SPECIFIES THAT BACKSPACE IS TO BE USED TO DELETE A CHARACTER. THIS IS THE SYSTEM DEFAULT VALUE. NOCHAR - SPECIFIES THAT THERE IS NO CHARACTER DELETE CHARACTER. PROMPT - SPECIFIES THAT THE USER IS TO BE PROMPTED FOR NECESSARY INFORMATION. NOPROMPT - SPECIFIES THAT THE USER IS NOT TO BE PROMPTED FOR INFORMATION. INTERCOM - SPECIFIES THAT THE USER WILL ACCEPT MESSAGES FROM OTHER TERMINAL USERS. NOINTERCOM - SPECIFIES THAT THE USER WILL NOT ACCEPT MESSAGES FROM OTHER TERMINAL USERS. PAUSE - SPECIFIES THAT SECOND LEVEL MESSAGES WILL BE AVAILABLE TO THE USER WHILE OPERATING IN A COMMAND PROCEDURE. IF SPECIFIED, THE SYSTEM WILL PROMPT THE USER TO ENTER A QUESTION MARK OR A NULL LINE AFTER A COMMAND THAT HAS ISSUED A MESSAGE WITH MULTIPLE LEVELS OF OUTPUT. PROFILE Page 141 PROFILE NOPAUSE- SPECIFIES THAT SECOND LEVEL MESSAGES WILL NOT BE AVAILABLE TO THE USER WHILE OPERATING IN A COMMAND PROCEDURE. MSGID - SPECIFIES THAT TERMINAL MESSAGES WILL INCLUDE MESSAGE IDENTIFIERS. NOMSGID- SPECIFIES THAT TERMINAL MESSAGES WILL NOT INCLUDE MESSAGE IDENTIFIERS. MODE - SPECIFIES THAT THE USER WISHES TO RECEIVE MODE MESSAGES AT HIS TERMINAL NOMODE - SPECIFIES THAT THE USER DOES NOT WISH TO RECEIVE MODE MESSAGES AT HIS TERMINAL PREFIX('PREFIX') - SPECIFIES A PREFIX WHICH WILL BE APPENDED TO ALL NON-FULLY QUALIFIED DSNAMES. 'PREFIX' - IS ANY VALID DSNAME QUALIFIER OF 1-7 ALPHAMERIC CHARACTERS THAT BEGINS WITH AN ALPHABETIC OR NATIONAL CHARACTER NOPREFIX - SPECIFIES NO PREFIXING OF DSNAMES BY ANY QUALIFIER WILL BE PERFORMED WTPMSG - SPECIFIES THE USER WISHES TO RECEIVE WRITE TO PROGRAMMER MESSAGES AT HIS TERMINAL NOWTPMSG - SPECIFIES THE USER DOES NOT WISH TO RECEIVE WRITE TO PROGRAMMER MESSAGES AT HIS TERMINAL LIST - SPECIFIES THAT THE USER PROFILE IS TO BE LISTED. RECOVER- SPECIFIES THAT THE EDIT RECOVERY FUNCTION IS TO BE USED FOR ALL EDIT SESSIONS. NORECOVER - SPECIFIES THAT THE EDIT RECOVERY FUNCTION IS NOT TO BE USED FOR ALL EDIT SESSIONS. PURGE Page 142 PURGE COMMAND NAME - PURGE FUNCTION - THE PURGE COMMAND IS USED TO REQUEST THAT JES2 PURGE A JOB FROM ITS QUEUES.IF THE PURGE COMMAND IS ISSUED BEFORE THE JOB HAS BEEN EXECUTED, THE JOB WILL NOT BEGIN EXECUTION. SYNTAX - PURGEJOB('JOB-ID')/TSU('NUMBER') REQUIRED - 'JOB-ID' DEFAULTS - NONE ALIASES- NONE OPERANDS - JOB('JOB-ID') - THE JOB TO BE PURGED 'JOB-ID' - THE JES2 JOB NUMBER OR THE JOB NAME (RECEIPT NUMBER) OF THE DESIRED JOB. TSU('NUMBER') - THE TIME SHARING SESSION GIVEN BY ITS NUMBER IS TO BE PURGED. THIS CAN BE USED TO CANCEL OUTPUT GENERATED BY A PREVIOUS SESSION. COMMAND NAME - QED SUBCOMMANDS - ALTER,BOTTOM,CHANGE,CL,COPY,DELETE,DLIM,DOWN,DSN,END,FIELD,FIND, GTAB,INCLUDE,INPUT,INSERT,LIST,MERGE,MOVE,RENUM,RF,RLN,RS,SAVE,SCAN, SCHEDULE,SCLR,SCREEN,TABSET,TERMON,TN,TOP,TSO,UNNUM,UP,VERIFY,WHERE. FOR HELP WITH INSERT/REPLACE/DELETE TYPE HELP LINEDIT. TO INVOKE TSO COMMANDS WHOSE NAMES CONFLICT WITH QED SUBCOMMANDS, ENTER TSO, A SPACE, AND THEN THE TSO COMMAND. FOR A LIST OF QED ABBREVIATIONS, TYPE HELP ABBREV. FUNCTION - THE QED COMMAND IS USED TO CREATE OR MODIFY SEQUENTIAL DATA SETS OR MEMBERS OF PARTITIONED DATA SETS. QED Page 143 QED SYNTAX - QED 'DSNAME' NEW/OLD SCAN/NOSCAN ASM/CLIST/CNTL/COBOL/DATA/FORTGI/FORTH/PLI/PLIF/SNOB/SPSS/TEXT NUM/NONUM BLOCK('N5') LINE('N6') CAPS/ASIS EMODE/IMODE REQUIRED - 'DSNAME' DEFAULTS - NUM,NOSCAN NOTE - IF THE FULLY QUALIFIED DATA SET NAME IS SPECIFIED, IT MUST BE ENCLOSED IN SINGLE QUOTES. OPERANDS - 'DSNAME' - NAME OF THE DATA SET TO BE CREATED OR EDITED. NEW - DATA SET NAMED DID NOT EXIST BEFORE COMMAND WAS ISSUED. OLD - DATA SET ALREADY EXISTED WHEN THE QED COMMAND WAS ISSUED. SCAN - FOR DATA SET TYPE FORTG,FORTH,PLIF,PLI, EACH LINE IS TO BE CHECKED FOR SYNTAX. NOSCAN - NO SYNTAX CHECKING IS TO BE PERFORMED. ASM - DATA CONSISTS OF ASSEMBLER SOURCE STATEMENTS. CLIST - DATA IS INPUT FOR THE EXEC COMMAND. CNTL - DATA CONSISTS OF JOB CONTROL STATEMENTS. COBOL - DATA CONSISTS OF COBOL SOURCE STATEMENTS. DATA - DATA IS TO BE INPUT TO A PROGRAM. FORTGI - DATA CONSISTS OF FORTRAN IV (G1) SOURCE STATEMENTS. FORTH - DATA CONSISTS OF FORTRAN IV (H) SOURCE STATEMENTS. PLI - DATA CONSISTS OF PL/I (X) SOURCE STATEMENTS. QED Page 144 QED PLIF - DATA CONSISTS OF PL/I (F) SOURCE STATEMENTS. SNOB - DATA CONSISTS OF SNOBOL SOURCE STATEMENTS. SPSS - DATA IS INPUT FOR SPSS. TEXT - DATA IS PROSE. DEFAULT CHARACTER CONVERSION IS ASIS. NUM - IF THE DATA SET IS NEW, RECORDS WILL CONTAIN LINE NUMBERS. IF OLD, THE RECORDS DO CONTAIN LINE NUMBERS. NONUM - RECORDS WILL NOT CONTAIN LINE NUMBERS. CANNOT BE SPECIFIED FOR GOFORT, IPLI, OR BASIC DATA SETS. BLOCK('N5') - BLOCKSIZE, FOR NEW DATA SETS ONLY. 'N5' - THE MAXIMUM BLOCK LENGTH IN BYTES. LINE('N6') - LOGICAL RECORD LENGTH, FOR NEW DATA SETS ONLY. 'N6' - LENGTH IN BYTES. CAPS - DATA LOWER CASE LETTERS ARE TO BE CONVERTED TO CAPITAL LETTERS, THE DEFAULT FOR ALL DATA SET TYPES EXCEPT TEXT. ASIS - INPUT LOWER CASE LETTERS ARE NOT TO BE CONVERTED TO UPPER CASE. THIS IS THE DEFAULT FOR TEXT TYPE DATA SETS. EMODE - EDITING IS TO BEGIN IN EDIT MODE, EVEN IF THE DATA SET IS NEW. IMODE - EDITING IS TO BEGIN IN INPUT MODE, EVEN IF THE DATA SET IS OLD. SUBCOMMAND ABBREV QED Page 145 QED QED SUPPORTS SEVERAL ABBREVIATIONS FOR COMMONLY USED COMMANDS. THESE ABBREVATIONS AND THEIR MEANING ARE SHOWN BELOW. THE FOLLOWING ABBREVIATIONS ARE SUPPORTED: / - LIST * + - DOWN - - UP _ - TN, CHANGE * 99999 | - TN, FIND = - TN, VERIFY, FIND < - TN, VERIFY, CHANGE * 999999 ! - TABSET ON(10 16 35 72), FIELD 71 ON # - UP 2, L * 5, UP 2 FT - TN, FIND CT - TN, CHANGE * 99999 THE + AND - CHARACTERS MAY OPTIONALLY BE FOLLOWED BY A / SEQUENCE. FOR EXAMPLE, -3/5 MEANS UP 3, LIST * 5; +2/9 MEANS DOWN 2, LIST * 9. SUBCOMMAND ALTER (MAY BE ABBREVIATED A) FUNCTION - THE ALTER SUBCOMMAND CAUSES QED TO DISPLAY A PARTICULAR LINE AND THEN POSITION THE CARRAIGE/CURSOR BELOW THE DISPLAYED LINE. THE CHARACTERS ENTERED BY THE USER ON THE SECOND LINE WILL REPLACE THE CORRESPONDING CHARACTERS ON THE DISPLAYED LINE. THE USER MAY SPECIFY THE COLUMN NUMBER OR CHARACTER STRING UNDER WHICH THE CARRAIGE/CURSOR IS TO BE PLACED AND ONLY THE CHARACTERS ENTERED BY THE USER WILL CAUSE MODIFICATION TO THE DISPLAYED LINE. NOTE THAT A LINE MAY NOT BE LENGTHENED OR SHORTENED BY THE ALTER SUBCOMMAND. SYNTAX - ALTER 'LINE-NUMBER' 'COLUMN-NUMBER'/'CHARACTER-STRING' REQUIRED: NONE DEFAULTS: 'LINE-NUMBER' DEFAULTS TO THE CURRENT LINE POINTER. 'COLUMN-NUMBER' DEFAULTS TO 1. OPERANDS - 'LINE-NUMBER' - SPECIFIES THE LINE NUMBER OF THE LINE WHICH IS TO BE ALTERED. IF THIS OPERAND IS OMITTED THEN IT WILL DEFAULT TO THE CURRENT LINE POINTER. QED Page 146 QED 'COLUMN-NUMBER' - SPECIFIES THE COLUMN NUMBER OF THE DISPLAYED LINE UNDER WHICH THE CARRAIGE/CURSOR IS TO BE PLACED. 'CHARACTER-STRING' - SPECIFIES THE CHARACTER STRING IN THE DISPLAYED LINE UNDER WHICH THE CARRAIGE/CURSOR IS TO BE PLACED. SUBCOMMAND BOTTOM (MAY BE ABBREVIATED B) FUNCTION - THE BOTTOM SUBCOMMAND REPOSITIONS THE CURRENT LINE INDICATOR TO THE LAST LINE OF THE DATA SET BEING EDITED. SYNTAX - BOTTOM REQUIRED - NONE DEFAULTS - NONE ALIAS- B OPERANDS - NONE SUBCOMMAND CHANGE (MAY BE ABBREVIATED C) FUNCTION - THE CHANGE SUBCOMMAND IS USED TO MODIFY A CHARACTER-STRING IN A LINE OR RANGE OF LINES. SYNTAX - CHANGE 'LINE-SPEC' 'COUNT2'/'CHAR-STRING'/=TEXT1=TEXT2=ALL FIELD( 'START-COL' 'END-COL') REQUIRED - 'COUNT2'/'CHAR-STRING'/=TEXT1=TEXT2 DEFAULTS - 'LINE-SPEC' DEFAULTS TO * . ALIAS- C OPERANDS - 'LINE-SPEC' - * FOR THE CURRENT LINE. * 'COUNT1' OR 'LINENUM1,LINENUM2' FOR A RANGE OF LINES. 'LINENUM' FOR A PARTICULAR LINE. 'COUNT2' - THE SPECIFIED NUMBER OF CHARACTERS IS PRINTED FROM THE BEGINNING OF EACH LINE SPECIFIED. THE USER RESPONDS BY COMPLETING THE LINE(S). QED Page 147 QED 'CHAR-STRING' - A SEARCH FOR THE SPECIFIED CHARACTER STRING IS MADE IN THE LINE(S) SPECIFIED. THE FIRST LINE IN WHICH IT IS FOUND IS PRINTED UP TO THE STRING, AND THE USER COMPLETES THE LINE. '=TEXT1=TEXT2='ALL - = MAY BE ANY NON-NUMERIC CHARACTER EXCEPT BLANK, COMMA, TAB,PARENTHESIS,ASTERISK,SLASH,OR SEMICOLON. IT DELIMITS, IS NOT A PART OF, AND CANNOT APPEAR WITHIN THE CHARACTER STRINGS TEXT1 AND TEXT2. THE LINE OR RANGE OF LINES IS SEARCHED FOR TEXT1, WHICH, IF FOUND, IS REPLACED BY TEXT2. THE KEYWORD 'ALL' IS OPTIONAL AND CAUSES EVERY OCCURRENCE OF TEXT1 TO BE REPLACED IN THE LINE(S). EXAMPLES - ==TEXT2= TEXT2 WILL BE INSERTED IN FRONT OF THE LINE(S). 'TEXT1'' TEXT1 WILL BE DELETED FROM THE LINE(S). FIELD - SPECIFIES THAT THE SCOPE OF THIS CHANGE SUBCOMMAND IS TO BE RESTRICTED TO A SPECIFIC SUBFIELD OF THE RECORD. SEE THE FIELD SUBCOMMAND FOR A DESCRIPTION OF THE MEANING OF THE FIELD SUBOPERANDS. NOTE THAT THIS OPERAND TEMPORARILY OVERRIDES ANY PREVIOUS FIELD SUBCOMMAND SPECIFICATION. SUBCOMMAND CL FUNCTION - THE CL SUBCOMMAND IS USED WITH THE TERMON SUBCOMMAND TO ALLOW TEMPORARY EXIT AND RESUMPTION OF CLISTS. THE CL SUBCOMMAND RESUMES EXECUTION OF A CLIST HALTED VIA THE TERMON SUBCOMMAND. SYNTAX - CL OPERANDS - NONE SUBCOMMAND COPY FUNCTION - THE COPY SUBCOMMAND IS USED TO COPY ONE OR MORE RECORDS IN THE DATASET CURRENTLY BEING EDITED. THIS OPERATION MOVES WHOLE RECORDS FROM A SPECIFIED SOURCE LOCATION TO A TARGET LOCATION, LEAVING THE ORIGINAL LINES INTACT. THE COPIED LINES ARE ALWAYS INSERTED BETWEEN TWO EXISTING LINES IN THE QED Page 148 QED DATASET. NO EXISTING LINES ARE EVER OVERWRITTEN IN THE COPY PROCESS. SYNTAX - COPY 'LINE-SPEC1' 'LINE-SPEC2' INCR('LINES') REQUIRED - NONE DEFAULT- IF COPY IS ENTERED WITHOUT OPERANDS, THE CURRENT LINE IS COPIED TO CURRENT-LINE + "BEST-FIT" NOTE - THE TARGET LINE MAY NOT BE IN THE SOURCE AREA, EXCEPT FOR THE LAST SOURCE LINE. NOTE - IF THE NUMBER OF LINES IN THE SOURCE AREA IS TOO GREAT TO FIT IN THE TARGET AREA, THAN YOU WILL BE PROMPTED FOR PERMISSION TO RENUMBER ENOUGH LINES TO FIT THE DATA. OPERANDS - 'LINE-SPEC1' - SPECIFIES THE EXISTING LINES WHICH ARE TO BE COPIED. * FOR THE CURRENT LINE, * 'COUNT1' OR 'STRING' 'COUNT' OR 'LINENUM1' 'LINENUM2' FOR A RANGE OF LINES. 'STRING' - SPECIFIES THAT THE FIRST OR ONLY LINE TO BE COPIED IS THE FIRST LINE AFTER THE CURRENT LINE POINTER CONTAINING THE SPECIFIED STRING. 'LINE-SPEC2' - SPECIFIES THE TARGET AREA FOR THE COPY. IF THIS LINE ALREADY EXISTS THEN THE COPY WILL BEGIN AT THIS LINE PLUS THE INCREMENT. * FOR THE CURRENT LINE, 'LINENUM3' FOR A SPECIFIC LINE NUMBER OR FOR THE RELATIVE LINE NUMBER (THE N'TH LINE IN AN UNNUMBERED DATASET) INCR('LINES') - SPECIFIES THE LINE NUMBER INCREMENT TO BE USED FOR THIS COPY OPERATION. IF OMITTED OR IF THE LINES WILL NOT FIT, THEN A "BEST-FIT" INCREMENT WILL BE USED. SUBCOMMAND DELETE FUNCTION - DELETE REMOVES RECORDS FROM THE DATA SET. THE CURRENT LINE INDICATOR * IS REPOSITIONED PRIOR TO THE DELETED LINES. SYNTAX - DELETE 'LINE-SPEC' QED Page 149 QED REQUIRED - NONE DEFAULTS - * OPERANDS - 'LINE-SPEC' - * FOR CURRENT LINE. * 'COUNT' OR 'LINENUM1,LINENUM2' FOR A RANGE OF LINES. 'LINENUM' FOR A PARTICULAR LINE. SUBCOMMAND DOWN (MAY BE ABBREVIATED D) FUNCTION - DOWN MOVES THE CURRENT LINE POINTER * TOWARD THE END OF THE DATA SET. SYNTAX - DOWN 'COUNT' REQUIRED - NONE DEFAULTS - 'COUNT' DEFAULTS TO 1 . ALIAS- D OPERANDS - 'COUNT'- SPECIFIES THE NUMBER OF LINES * IS TO BE MOVED. SUBCOMMAND DSN FUNCTION - THE DSN SUBCOMMAND IS USED TO PRINT THE NAME OF THE CURRENT QED DATASET. THIS IS USEFUL IF YOU ARE USING QED UNDER QED. SYNTAX - DSN ATTR REQUIRED: NONE. OPERANDS ATTR - SPECIFIES THAT THE ATTRIBUTES OF THE DATA SET SHOULD BE DISPLAYED ALONG WITH THE NAME. SUBCOMMAND END QED Page 150 QED FUNCTION - END REQUESTS THAT THE QED COMMAND BE TERMINATED AND CONTROL RETURNED TO THE INVOKING PROGRAM LEVEL THAT ACCEPTS SYSTEM COMMANDS. SYNTAX - END SAVE/NOSAVE REQUIRED - NONE DEFAULTS - NONE OPERANDS - SAVE - SAVE THE DATA SET UNDER THE ORIGINAL DSN SPECIFIED IN THE QED COMMAND AND THEN EXIT FROM THIS QED SESSION. NOSAVE- END THIS QED SESSION AND DO NOT REQUIRE THE USER TO ENTER 'END' TWICE . THIS OPERAND WILL PREVENT AN ERROR MESSAGE BEING SENT IF THE USER HAS CHANGED HIS DATA SET SINCE THE LAST SAVE SUBCOMMAND. SUBCOMMAND FIELD FUNCTION - THE FIELD COMMAND IS USED TO SPECIFY THAT SUBSEQUENT CHANGE, FIND, AND LIST SUBCOMMANDS ARE TO BE RESTRICTED IN SCOPE TO A SPECIFIC FIELD WITHIN THE RECORDS IN THE DATASET. ONCE A FIELD IS SPECIFIED, THEN ONLY CHARACTER STRINGS WHICH APPEAR WITHIN THE SPECIFIED AREA OF THE RECORD MAY BE LOCATED WITH THE FIND SUBCOMMAND OR MODIFIED WITH THE CHANGE SUBCOMMAND. POSITION SPECIFICATIONS WITH THE FIND AND CHANGE SUBCOMMANDS BECOME RELATIVE TO THE START OF THE FIELD, NOT THE ENTIRE RECORD. SYNTAX - FIELD 'POS1' 'POS2'/* ON/OFF TRUNC/NOTRUNC LIST/NOLIST REQUIRED - NONE DEFAULTS - ON, TRUNC, NOLIST OPERANDS - 'POS1' - SPECIFIES THE STARTING POSITION (COLUMN) FOR THE FIELD. IF 'POS2' IS NOT SPECIFIED, THEN THE FIELD STARTS AT 'POS1' AND HAS LENGTH 'POS1'. 'POS2' - SPECIFIES THE ENDING POSITION (COLUMN) FOR THE FIELD INCLUDING 'POS2'. QED Page 151 QED * - SPECIFIES THAT 'POS2' IS TO BE THE END OF THE RECORD. ON - SPECIFIES THAT THE FIELD SPECIFICATION SHOULD TAKE EFFECT NOW. OFF - SPECIFIES THAT THE FIELD SPECIFICATION IS NOT TO TAKE EFFECT NOW. A SUBSEQUENT FIELD ON MAY BE USED TO REACTIVATE FIELD PROCESSING. THE FIELD SPECIFICATION IS NOT DESTROYED BETWEEN FIELD OFF - FIELD ON REQUESTS. TRUNC- SPECIFIES THAT NON-BLANKS EXPANDING OUTSIDE OF THE FIELD (DUE TO A CHANGE SUBCOMMAND) WILL BE TRUNCATED ON THE RIGHT HAND SIDE. NOTRUNC - SPECIFIES THAT NON-BLANKS ARE NOT TO BE TRUNCATED IF THEY WOULD HAVE EXPANDED OUTSIDE THE FIELD. INSTEAD AN ERROR MESSAGE IS ISSUED. LIST - SPECIFIES THAT ONLY THE POSITIONS WITHIN THE FIELD ARE TO BE DISPLAYED IN RESPONSE TO A LIST SUBCOMMAND (OR A LIST DUE TO VERIFY) NOLIST - SPECIFIES THAT THE FUNCTION OF THE LIST SUBCOMMAND IS TO REMAIN UNCHANGED. SUBCOMMAND FIND (MAY BE ABBREVIATED F) FUNCTION - FIND SEARCHES FOR A SPECIFIED CHARACTER STRING BEGINNING WITH THE CURRENT LINE, PROVIDED OPERANDS ARE SPECIFIED (SEE SYNTAX). THE CURRENT LINE POINTER * IS MOVED TO THE FIRST LINE FOUND TO CONTAIN THE STRING. THE SEARCH IS MADE AT A SPECIFIED OFFSET OR AT EVERY POSITION WITHIN EACH LINE. SYNTAX - FIND '=CHAR-STRING=' 'POSITION' ALL FIELD('START-COL' 'END-COL') REQUIRED - NONE DEFAULTS - IF NO OPERANDS ARE SPECIFIED, THOSE SPECIFIED ON THE LAST PREVIOUS ISSUE OF THE FIND SUBCOMMAND ARE ASSUMED. THE SEARCH BEGINS AT THE LINE FOLLOWING THE CURRENT LINE. QED Page 152 QED ALIAS- F OPERANDS - '=CHAR-STRING=' - = CAN BE CHOSEN TO BE ANY NON-NUMERIC CHARACTER, EXCEPT BLANK, COMMA, TAB, PARENTHESIS, ASTERISK, SLASH, OR SEMICOLON, WHICH DOES NOT APPEAR WITHIN THE SPECIFIED CHARACTER STRING. THE SECOND OCCURRENCE CAN BE REPLACED BY CARRIAGE RETURN IF 'POSITION' IS NOT SPECIFIED. 'POSITION' - SPECIFIES THE COLUMN WITHIN EACH LINE AT WHICH THE COMPARISON IS TO BE MADE. VALID ONLY IF CHARACTER STRING IS SPECIFIED ALSO. IF CHARACTER STRING IS SPECIFIED AND THIS OPERAND IS OMITTED, THE COMPARISON IS MADE AT EVERY COLUMN WITHIN EACH LINE. ALL - SPECIFIES THAT ALL OCCURENCES OF THE STRING ARE TO BE FOUND. EACH OCCURENCE WILL BE DISPLAYED, EVEN IF THE VERIFY INDICATOR IS CURRENTLY OFF. FIELD - SPECIFIES THAT THE SCOPE OF THIS FIND SUBCOMMAND IS TO BE RESTRICTED TO A SUBFIELD OF EACH RECORD. SEE THE FIELD SUBCOMMAND FOR A DESCRIPTION OF THE FIELD SUBOPERANDS. NOTE THAT THIS OPERAND TEMPORARILY OVERRIDES ANY PREVIOUS FIELD SUBCOMMAND SPECIFICATION. SUBCOMMAND INCLUDE (MAY BE ABBREVIATED INC) FUNCTION - INCLUDE CAUSES ALL OR PART OF A SPECIFIED DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. ONLY THE DATA SET BEING EDITED IS ALTERED. THIS SUBCOMMAND IS ACTUALLY JUST AN ALIAS FOR THE MERGE SUBCOMMAND AND HAS EXACTLY THE SAME SYNTAX AND FUNCTION. SYNTAX - INCLUDE 'DSNAME' 'LINENUM1,LINENUM2'/'STRING,COUNT' 'LINENUM3'/* INCR('INTEGER') NUM/NONUM REQUIRED - 'DSNAME' DEFAULTS - THE ENTIRE DATASET IS MERGED. QED Page 153 QED OPERANDS - 'DSNAME' - THE DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. 'LINENUM1,LINENUM2' - SPECIFIES A RANGE OF LINES IN THE DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. IF THIS OPERAND IS OMITTED THE ENTIRE DATA SET IS MERGED INTO THE DATA SET BEING EDITED. IF THE NONUM KEYWORD OF THIS SUBCOMMAND IS ENTERED OR DEFAULTED, 'LINENUM1,LINENUM2' IS A RELATIVE RECORD NUMBER SPECIFICATION,E.G. 1 -THE FIRST RECORD, 10 -THE TENTH RECORD. 'STRING,COUNT' - SPECIFIES THAT THE MERGE IS TO BEGIN WITH THE FIRST LINE IN THE DATASET CONTAINING THE SPECIFIED STRING AND CONTINUE FOR 'COUNT' LINES. 'LINENUM3' - SPECIFIES A LINE NUMBER IN THE DATA SET BEING EDITED. MERGED RECORDS WILL BE INSERTED FOLLOWING THIS LINE. A RELATIVE RECORD NUMBER IS SPECIFIED WHEN THE EDIT DATA SET IS NOT LINE NUMBERED. * - FOLLOWING ONE OR TWO OTHER POSITIONAL OPERANDS, * CAUSES THE MERGED RECORDS TO BE INSERTED FOLLOWING THE CURRENT LINE POSITION IN THE DATA SET BEING EDITED. INCR('INTEGER') - SPECIFIES THE INCREMENT TO BE USED FOR RENUMBERING THE LINES ADDED TO THE EDIT DATASET. IF OMITTED OR IF THE LINES WILL NOT FIT, THEN A "BEST-FIT" INCREMENT IS USED. NUM - SPECIFIES THAT THE DATA SET TO BE MERGED INTO THE EDIT DATA SET IS LINE-NUMBERED. THIS KEYWORD IS DEFAULTED WHEN 'NUM' IS ENTERED(OR DEFAULTED) ON THE QED COMMAND. IT NEED ONLY BE SPECIFIED WHEN THE EDIT DATA SET IS NOT LINE NUMBERED. NONUM - SPECIFIES THAT THE DATA SET TO BE MERGED INTO THE EDIT DATA SET IS NOT LINE NUMBERED. THIS KEYWORD IS A DEFAULT WHEN 'NONUM' IS ENTERED ON THE QED COMMAND. THE USER MUST SPECIFY THIS KEYWORD (FOR DATA SETS NOT LINE NUMBERED) WHEN THE EDIT DATA SET IS LINE-NUMBERED. SUBCOMMAND INPUT (MAY BE ABBREVIATED I) QED Page 154 QED FUNCTION - INPUT CAUSES A SWITCH TO INPUT MODE SO THAT LINES MAY BE ADDED OR REPLACED. SYNTAX - INPUT 'LINENUM' 'INCREM' R/I PROMPT/NOPROMPT OR * R/I PROMPT/NOPROMPT REQUIRED - NONE DEFAULTS - I ALIAS- I OPERANDS - 'LINENUM' - THE FIRST LINE INSERTED WILL HAVE THIS NUMBER, OR THIS NUMBER PLUS THE INCREMENT IF THE SPECIFIED LINE NUMBER ALREADY EXISTS. 'INCREM' - SPECIFIES THE INCREMENT FOR NUMBERING INSERTED LINES. THE DEFAULT IS THE PREVIOUSLY SPECIFIED INCREMENT OR 10 IF NO INCREMENT HAS BEEN SPECIFIED. * - FOR LINE NUMBERED DATA SETS, LINES ARE TO BE INSERTED AT THE POSITION DETERMINED BY THE CURRENT LINE POSITION PLUS THE DEFAULT INCREMENT. FOR NON-NUMBERED DATA SETS, LINES ARE TO BE INSERTED FOLLOWING THE CURRENT LINE POSITION. R - THIS OPERAND CAN BE USED TO REPLACE LINES. CONSULT THE USER'S REFERENCE MANUAL FOR DETAILS. I - LINES ARE TO BE INSERTED INTO THE DATA SET WITH NO CHANGES TO EXISTING LINES. PROMPT - FOR LINE NUMBERED DATA SETS, EACH NEW LINE NUMBER IS PRINTED AT THE TERMINAL. FOR NON-NUMBERED DATA SETS, A PROMPT CHARACTER IS PRINTED BEFORE EACH NEW INPUT LINE. NOPROMPT - NEITHER LINE NUMBERS NOR A PROMPT CHARACTER ARE TO BE PRINTED BEFORE NEW INPUT LINES. SUBCOMMAND INSERT (MAY BE ABBREVIATED IN) FUNCTION - THE INSERT SUBCOMMAND CAN BE USED TO PLACE RECORDS AFTER THE CURRENT LINE POSITION * . QED Page 155 QED SYNTAX - INSERT 'CHAR-STRING' REQUIRED - NONE DEFAULTS - NONE ALIAS- IN OPERANDS - 'CHAR-STRING' - THE CHARACTER STRING WILL BE INSERTED AS A RECORD IN THE POSITION FOLLOWING THE CURRENT LINE POSITION, AND IN THE CASE OF A LINE NUMBERED DATA SET, WITH A LINE NUMBER ONE GREATER THAN THAT OF THE CURRENT LINE. IF THIS OPERAND IS OMITTED, INPUT MODE IS ENTERED WITH EACH NEW INPUT RECORD INSERTED FOLLOWING THE CURRENT LINE POSITION, AND LINE NUMBERED USING AN INCREMENT OF ONE. SUBCOMMAND LINEDIT FUNCTION - THE LINE INSERT/REPLACE/DELETE FUNCTION ALLOWS A SINGLE LINE TO BE ADDED, REPLACED, OR DELETED FROM THE DATA SET BEING EDITED. SYNTAX - 'LINENUM'/* 'CHAR-STRING' REQUIRED - 'LINENUM' OR * DEFAULTS - NONE NOTE - IF SPECIFIED, 'CHAR-STRING' MUST BE SEPARATED FROM * OR 'LINENUM' BY A SINGLE BLANK OR TAB. OPERANDS - 'LINENUM' - VALID FOR A LINE NUMBERED DATA SET ONLY. 'LINENUM' WITH AN IMMEDIATE CARRIAGE RETURN CAUSES THE DELETION OF THE LINE HAVING THE SPECIFIED NUMBER, OR NO OPERATION IF SUCH A LINE DOES NOT EXIST. 'LINENUM' FOLLOWED BY A CHARACTER STRING ADDS THE STRING TO THE DATA SET. IF A LINE HAVING THE SPECIFIED NUMBER ALREADY EXISTS, IT IS REPLACED. * - IF FOLLOWED BY AN IMMEDIATE CARRIAGE RETURN, THE CURRENT LINE IS DELETED. IF FOLLOWED BY A CHARACTER STRING, THE CURRENT LINE IS REPLACED. 'CHAR-STRING' - SPECIFIES THE TEXT OF THE LINE TO BE ADDED. SUBCOMMAND LIST (MAY BE ABBREVIATED L) QED Page 156 QED FUNCTION - LIST DISPLAYS AT THE TERMINAL LINES OF THE DATA SET BEING EDITED. SYNTAX - LIST 'LINE-SPEC' NUM/SNUM FIELD('START-COL' 'END-COL') REQUIRED - NONE DEFAULTS - NUM ALIAS- L OPERANDS - 'LINE-SPEC' - * OR 'LINENUM' TO INDICATE A SINGLE LINE TO BE LISTED. * 'COUNT' OR 'LINENUM1,LINENUM2' TO DISPLAY A RANGE OF LINES. THE ENTIRE DATA SET WILL BE DISPLAYED IF THIS OPERAND IS OMITTED. NUM - THE LINE NUMBERS ARE TO BE DISPLAYED. SNUM - THE LINE NUMBERS ARE NOT TO BE DISPLAYED. FIELD - SPECIFIES ONLY A SPECIFIC SUBFIELD OF EACH RECORD IS TO BE DISPLAYED. SEE THE FIELD SUBCOMMAND FOR A DESCRIPTION OF THE MEANING OF THE FIELD SUBOPERANDS. NOTE THAT THIS OPERAND TEMPORARILY OVERRIDES ANY PREVIOUS FIELD SUBCOMMAND SPECIFICATION. SUBCOMMAND MERGE FUNCTION - MERGE CAUSES ALL OR PART OF A SPECIFIED DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. ONLY THE DATA SET BEING EDITED IS ALTERED. SYNTAX - MERGE 'DSNAME' 'LINENUM1,LINENUM2'/'STRING,COUNT' 'LINENUM3'/* INCR('INTEGER') NUM/NONUM REQUIRED - 'DSNAME' DEFAULTS - THE ENTIRE DATASET IS MERGED. OPERANDS - 'DSNAME' - THE DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. 'LINENUM1,LINENUM2' QED Page 157 QED - SPECIFIES A RANGE OF LINES IN THE DATA SET TO BE MERGED WITH THE DATA SET BEING EDITED. IF THIS OPERAND IS OMITTED THE ENTIRE DATA SET IS MERGED INTO THE DATA SET BEING EDITED. IF THE NONUM KEYWORD OF THIS SUBCOMMAND IS ENTERED OR DEFAULTED, 'LINENUM1,LINENUM2' IS A RELATIVE RECORD NUMBER SPECIFICATION,E.G. 1 -THE FIRST RECORD, 10 -THE TENTH RECORD. 'STRING,COUNT' - SPECIFIES THAT THE MERGE IS TO BEGIN WITH THE FIRST LINE IN THE DATASET CONTAINING THE SPECIFIED STRING AND CONTINUE FOR 'COUNT' LINES. 'LINENUM3' - SPECIFIES A LINE NUMBER IN THE DATA SET BEING EDITED. MERGED RECORDS WILL BE INSERTED FOLLOWING THIS LINE. A RELATIVE RECORD NUMBER IS SPECIFIED WHEN THE EDIT DATA SET IS NOT LINE NUMBERED. * - FOLLOWING ONE OR TWO OTHER POSITIONAL OPERANDS, * CAUSES THE MERGED RECORDS TO BE INSERTED FOLLOWING THE CURRENT LINE POSITION IN THE DATA SET BEING EDITED. INCR('INTEGER') - SPECIFIES THE INCREMENT TO BE USED FOR RENUMBERING THE LINES ADDED TO THE EDIT DATASET. IF OMITTED OR IF THE LINES WILL NOT FIT, THEN A "BEST-FIT" INCREMENT IS USED. NUM - SPECIFIES THAT THE DATA SET TO BE MERGED INTO THE EDIT DATA SET IS LINE-NUMBERED. THIS KEYWORD IS DEFAULTED WHEN 'NUM' IS ENTERED(OR DEFAULTED) ON THE QED COMMAND. IT NEED ONLY BE SPECIFIED WHEN THE EDIT DATA SET IS NOT LINE NUMBERED. NONUM - SPECIFIES THAT THE DATA SET TO BE MERGED INTO THE EDIT DATA SET IS NOT LINE NUMBERED. THIS KEYWORD IS A DEFAULT WHEN 'NONUM' IS ENTERED ON THE QED COMMAND. THE USER MUST SPECIFY THIS KEYWORD (FOR DATA SETS NOT LINE NUMBERED) WHEN THE EDIT DATA SET IS LINE-NUMBERED. SUBCOMMAND MOVE FUNCTION - THE MOVE SUBCOMMAND IS USED TO MOVE ONE OR MORE RECORDS IN THE DATASET CURRENTLY BEING EDITED. THIS OPERATION MOVES WHOLE RECORDS FROM A SPECIFIED SOURCE LOCATION TO A TARGET QED Page 158 QED LOCATION, DELETING THE ORIGINAL LINES. THE MOVED LINES ARE ALWAYS INSERTED BETWEEN TWO EXISTING LINES IN THE DATASET. NO EXISTING LINES ARE EVER OVERWRITTEN IN THE MOVE PROCESS. SYNTAX - MOVE 'LINE-SPEC1' 'LINE-SPEC2' INCR('LINES') REQUIRED - NONE DEFAULT- IF MOVE IS ENTERED WITHOUT OPERANDS, NO OPERATION TAKES PLACE. NOTE - THE TARGET LINE MAY NOT BE IN THE SOURCE AREA, EXCEPT FOR THE LAST SOURCE LINE. NOTE - IF THE NUMBER OF LINES IN THE SOURCE AREA IS TOO GREAT TO FIT IN THE TARGET AREA, THAN YOU WILL BE PROMPTED FOR PERMISSION TO RENUMBER ENOUGH LINES TO FIT THE DATA. OPERANDS - 'LINE-SPEC1' - SPECIFIES THE EXISTING LINES WHICH ARE TO BE MOVED. * FOR THE CURRENT LINE, * 'COUNT1' OR 'STRING' 'COUNT' OR 'LINENUM1' 'LINENUM2' FOR A RANGE OF LINES. 'STRING' - SPECIFIES THAT THE FIRST OR ONLY LINE TO BE MOVED IS THE FIRST LINE AFTER THE CURRENT LINE POINTER CONTAINING THE SPECIFIED STRING. 'LINE-SPEC2' - SPECIFIES THE TARGET AREA FOR THE MOVE. IF THIS LINE ALREADY EXISTS THEN THE MOVE WILL BEGIN AT THIS LINE PLUS THE INCREMENT. * FOR THE CURRENT LINE, 'LINENUM3' FOR A SPECIFIC LINE NUMBER OR FOR THE RELATIVE LINE NUMBER (THE N'TH LINE IN AN UNNUMBERED DATASET) INCR('LINES') - SPECIFIES THE LINE NUMBER INCREMENT TO BE USED FOR THIS MOVE OPERATION. IF OMITTED OR IF THE LINES WILL NOT FIT, THEN A "BEST-FIT" INCREMENT WILL BE USED. SUBCOMMAND RENUM (MAY BE ABBREVIATED REN) FUNCTION - RENUM RENUMBERS EACH LINE OF A LINE NUMBERED DATA SET OR ASSIGNS LINE NUMBERS TO EACH LINE OF A NON-NUMBERED DATA SET. QED Page 159 QED SYNTAX - RENUM 'NEW-LINENUM' 'INCREM' 'OLD-LINENUM' 'ENDING-LINENUM' REQUIRED - NONE DEFAULTS - BOTH 'NEW-LINENUM' AND 'INCREM' DEFAULT TO 10 . ALIAS- REN NOTE - 'NEW-LINENUM' IS REQUIRED IF 'INCREM' IS SPECIFIED. BOTH ARE REQUIRED IF 'OLD-LINENUM' IS SPECIFIED. OPERANDS - 'NEW-LINENUM' - THE NUMBER TO BE ASSIGNED TO THE FIRST LINE PROCESSED. 'INCREM' - SPECIFIES THE INCREMENT TO BE USED IN RENUMBERING. 'OLD-LINENUM' - SPECIFIES A LINE NUMBER IN THE DATA SET. NEW LINE NUMBERS ARE TO BE ASSIGNED BEGINNING WITH THIS LINE. THIS OPERAND IS VALID ONLY WITH LINE NUMBERED DATA SETS. IF THIS OPERAND IS OMITTED, THE ENTIRE DATA SET IS RENUMBERED. 'ENDING-LINENUM' - SPECIFIES THE LAST LINE WHICH IS TO BE RENUMBERED. IF THIS OPERAND IS OMMITTED THEN THE DATA SET WILL BE RENUMBERED TO THE END. SUBCOMMAND RF FUNCTION - THE RF (REPLACE FIELD) SUBCOMMAND REPLACES THE CONTENTS OF A SPECIFIC SUBFIELD OF A RECORD OR GROUP OF RECORDS WITHOUT REQUIRING VERIFICATION OF THE PREVIOUS CONTENTS OF THE SUBFIELD. THE SUBFIELD IS DESCRIBED BY AN INCLUSIVE PAIR OF COLUMN NUMBERS. SYNTAX - RF 'LINE-SPECIFICATON' 'START-COL' 'END-COL' 'STRING' REQUIRED: 'START-COL', 'END-COL', 'STRING'. DEFAULTS: 'LINE-SPECIFICATION' DEFAULTS TO CURRENT LINE POINTER. OPERANDS - 'LINE-SPECIFICATION' - SPECIFIES THE LINE OR RANGE OF LINES FOR WHICH THE FIELD IS TO BE REPLACED. * FOR THE CURRENT LINE. * 'COUNT' FOR A RANGE OF LINES. 'LINE1' FOR A SPECIFIC LINE NUMBER, AND 'LINE1' 'LINE2' FOR A RANGE OF LINE NUMBERS. 'START-COL' - SPECIFIES THE FIRST COLUMN NUMBER OF THE FIELD TO BE QED Page 160 QED REPLACED. 'END-COL' - SPECIFIES THE LAST COLUMN NUMBER OF THE FIELD TO BE REPLACED. 'STRING' - SPECIFIES THE CHARACTER STRING WHICH IS TO REPLACE THE FIELD SPECIFIED IN 'START-COL' AND 'END-COL'. SUBCOMMAND RLN FUNCTION - THE RLN SUBCOMMAND DISPLAYS THE RELATIVE LINE NUMBER OF THE CURRENT LINE IN THE DATASET. THE RELATIVE LINE NUMBER IS USEFUL FOR LINE SPECIFICATIONS IN THE DELETE, COPY, AND MOVE SUBCOMMANDS. SYNTAX - RLN OPERANDS - NONE SUBCOMMAND RS FUNCTION - THE RS (REPLACE STRING) SUBCOMMAND ALLOWS FOR THE REPLACEMENT OF A CHARACTER STRING IN A RECORD WITHOUT COMPLETELY SPECIFYING THE CHARACTER STRING WHICH IS TO BE REPLACED. THIS SUBCOMMAND WORKS JUST LIKE THE CHANGE SUBCOMMAND WITH TWO CHARACTER STRINGS SPECIFIED WITH THE EXCEPTION THAT THE STRING TO BE REPLACED IS IDENTIFIED BY TWO CHARACTER STRINGS. THE FIRST CHARACTER STRING SPECIFIES THE FIRST FEW CHARACTERS OF THE STRING TO BE REPLACED AND THE SECOND CHARACTER STRING SPECIFIES THE DELIMITING STRING WHICH FOLLOWS THE CHARACETR STRING TO BE REPLACED. THE THIRD CHARACTER STRING SPECIFIES THE REPLACEMENT STRING. IF THE SECOND STRING IS SPECIFIED AS NULL THEN THE FIRST COMMA OR BLANK WILL DELIMIT THE STRING TO BE REPLACED. SYNTAX - RS 'LINE-SPEC' 'START-STRING' 'DELIM-STRING' 'NEW-STRING' FIELD('START-COL' 'END-COL') REQUIRED: 'START-STRING', 'DELIM-STRING', 'NEW-STRING'. DEFAULTS: 'LINE-SPEC' DEFAULTS TO THE CURRENT LINE POINTER. QED Page 161 QED OPERANDS - 'LINE-SPEC' - SPECIFIES THE LINE IN WHICH THE STRING IS TO BE REPLACED. 'START-STRING' - SPECIFIES THE FIRST FEW CHARACTERS OF THE STRING TO BE REPLACED. 'DELIM-STRING' - SPECIFIES THE CHARACTER STRING WHICH IMMEDIATELY FOLLOWS THE STRING TO BE REPLACED. IF THIS STRING IS SPECIFIED AS NULL THEN THE FIRST COMMA OR BLANK FOLLOWING 'START-STRING' WILL DELIMIT THE STRING TO BE REPLACED. 'NEW-STRING' - SPECIFIES THE STRING WHICH IS TO REPLACE THE STRING IDENTIFIED BY 'START-STRING' AND 'DELIM-STRING'. FIELD - SPECIFIES THAT THE SCOPE OF THIS RS SUBCOMMAND IS TO BE RESTRICTED TO A PARTICULAR SUBFIELD OF THE RECORD. SEE THE FIELD SUBCOMMAND FOR A DESCRIPTION OF THE MEANING OF THE FIELD SUBOPERANDS. NOTE THAT THIS OPERAND TEMPORARILY OVERRIDES ANY PREVIOUS FIELD SUBCOMMAND SPECIFICATION. SUBCOMMAND SAVE (MAY BE ABBREVIATED S) FUNCTION - SAVE IS USED TO RETAIN THE DATA SET BEING EDITED. SYNTAX - SAVE 'DSNAME' REQUIRED - NONE DEFAULTS - 'DSNAME' DEFAULTS TO THE DATA SET NAME SPECIFIED WITH THE QED COMMAND. ALIAS- S NOTE - SAVE MUST BE ISSUED IF THE USER WANTS TO RETAIN A NEW DATA SET CREATED BY THE QED COMMAND, OR TO INCORPORATE INTO AN OLD DATA SET CHANGES MADE UNDER EDIT. OPERANDS - 'DSNAME' - NAME TO BE ASSIGNED THE RETAINED COPY. IF 'DSNAME' + SPECIFIES AN EXISTING PARTIONED DATA SET (PDS), WITHOUT SPECIFYING MEMBER NAME, MEMBER NAME 'TEMPNAME' IS USED. A NEW MEMBER IS CREATED IF NAMED MEMBER DOES NOT EXIST. + SPECIFIES AN EXISTING SEQUENTIAL DATA SET OR PDS MEMBER DIFFERENT FROM THAT SPECIFIED WITH THE QED COMMAND, THE USER WILL BE NOTIFIED. ANOTHER DATA SET NAME OR A CARRIAGE QED Page 162 QED RETURN CAN BE ENTERED. A CARRIAGE RETURN WILL CAUSE THE SPECIFIED DATA SET OR PDS MEMBER TO BE REPLACED. + SPECIFIES A DATA SET WHICH DOES NOT ALREADY EXIST, A NEW SEQUENTIAL DATA SET, OR PDS IF A MEMBER NAME IS STATED, WILL BE ALLOCATED. SUBCOMMAND SCAN (MAY BE ABBREVIATED SC) FUNCTION - SCAN IS USED TO SYNTAX CHECK A LINE OR RANGE OF LINES, OR TO CONTROL WHETHER ALL SUBSEQUENT LINES ENTERED DURING INPUT MODE ARE TO BE SYNTAX CHECKED. VALID ONLY FOR FORTE,FORTG,FORTGI,FORTH,GOFORT,PLIF, PLI,IPLI, AND BASIC TYPE DATA SETS. SYNTAX - SCAN 'LINE-SPEC'/ON/OFF REQUIRED - NONE DEFAULTS - NONE ALIAS- SC NOTE - IF NO OPERAND IS SPECIFIED, EVERY LINE OF THE DATA SET BEING EDITED WILL BE SYNTAX CHECKED. OPERANDS - 'LINE-SPEC' - SPECIFIES THE LINE(S) TO BE SYNTAX CHECKED. * FOR CURRENT LINE, 'LINENUM' FOR A PARTICULAR LINE, * 'COUNT' OR 'LINENUM1,LINENUM2' FOR A RANGE OF LINES. ON - SUCCEEDING INPUT LINES ARE TO BE SYNTAX CHECKED. OFF - SUCCEEDING INPUT LINES ARE NOT TO BE SYNTAX CHECKED. SUBCOMMAND STATE THE INFORMATION PREVIOUSLY AVAILABLE THROUGH THE STATE SUBCOMMAND IS NOW PROVIDED WITH THE ATTR OPERAND OF THE DSN SUBCOMMAND. QED Page 163 QED SUBCOMMAND TABSET (MAY BE ABBREVIATED TAB) FUNCTION - TABSET CAN BE USED TO RE-ESTABLISH TAB VALUES OR TO NULLIFY EXISTING TAB VALUES. SYNTAX - TABSET ON('INTEGER-LIST')/OFF/IMAGE REQUIRED - NONE DEFAULTS - ON ALIAS- TAB OPERANDS - ON('INTEGER-LIST') - SPECIFIES THAT THE TAB CHARACTER IS TO BE TRANSLATED INTO BLANKS CORRESPONDING TO THE CARD IMAGE FIELD. 'INTEGER-LIST' - SPECIFIES THE RELATIVE COLUMN POSITIONS IN EACH LINE TO WHICH TAB VALUES ARE TO BE SET. THIS OPERAND IS OPTIONAL. IF OMITTED, TAB VALUES DEFAULT TO THE PREVIOUS VALUES. UP TO TEN TAB VALUES CAN BE SET. OFF - TAB CHARACTERS ARE TO BE TRANSLATED INTO SINGLE BLANKS. IMAGE - SPECIFIES THAT THE USER WILL FOLLOW THE SUBCOMMAND WITH A NEW INPUT LINE DEFINING TAB VALUES TO BE SET. THIS LINE CONSISTS OF THE UPPER OR LOWER CASE LETTER T IN THOSE COLUMN POSITIONS FOR WHICH TAB VALUES ARE TO BE SET. UP TO TEN TAB VALUES CAN BE SET. THE OTHER POSITIONS OF THIS INPUT LINE MAY BE BLANK OR ANY OTHER CHARACTER EXCEPT T . SUBCOMMAND TERMON FUNCTION - THE TERMON SUBCOMMAND IS USED WITH THE CL SUBCOMMAND TO ALLOW TEMPORARY EXIT AND RESUMPTION OF CLISTS. THE TERMON SUBCOMMAND TEMPORARILY SUSPENDS EXECUTION OF THE CURRENT CLIST, ALLOWING INPUT TO BE ENTERED FROM THE TERMINAL UNTIL A CL SUBCOMMAND IS ENTERED, CAUSING THE CLIST TO RESUME. QED Page 164 QED SYNTAX - TERMON OPERANDS - NONE SUBCOMMAND TN FUNCTION - THE TN (TOP, NO VERIFY) SUBCOMMAND IS USED TO MOVE THE CURRENT LINE POINTER TO THE TOP OF THE DATASET WITHOUT LISTING THE FIRST LINE, EVEN IF VERIFY ON IS IN EFFECT. SYNTAX - TN OPERANDS - NONE SUBCOMMAND TOP FUNCTION - TOP CAUSES THE CURRENT LINE POSITION INDICATOR * TO BE POSITIONED BEFORE THE FIRST LINE OF THE DATA SET, OR AT LINE ZERO IF IT EXISTS. SYNTAX - TOP REQUIRED - NONE DEFAULTS - NONE ALIAS- T OPERANDS - NONE SUBCOMMAND TSO FUNCTION - THE TSO SUBCOMMAND IS USED TO INVOKE TSO COMMANDS WHICH HAVE THE SAME NAMES AS QED SUBCOMMANDS (COPY, DELETE, DSN, LIST, MERGE). COMMANDS HAVING DIFFERENT NAMES MAY BE ENTERED DIRECTLY. QED Page 165 QED SYNTAX - TSO 'TSO COMMAND AND OPERANDS' REQUIRED - 'TSO COMMAND AND OPERANDS' OPERANDS - 'TSO COMMAND AND OPERANDS' - SPECIFIES A TSO COMMAND, POSSIBLY FOLLOWED BY OPERANDS. SUBCOMMAND UNNUM (MAY BE ABBREVIATED UNN) FUNCTION - THE UNNUM SUBCOMMAND IS USED TO REMOVE EXISTING LINE NUMBERS FROM THE RECORDS IN THE DATASET. SYNTAX - UNNUM ALIAS- UNN OPERANDS - NONE SUBCOMMAND UP FUNCTION - UP MOVES THE CURRENT LINE POINTER * TOWARD THE BEGINNING OF THE DATA SET. SYNTAX - UP 'COUNT' REQUIRED - NONE DEFAULTS - 'COUNT' DEFAULTS TO 1 . OPERANDS - 'COUNT'- SPECIFIES THE NUMBER OF LINES THAT THE CURRENT LINE POINTER * IS TO BE MOVED. SUBCOMMAND VERIFY (MAY BE ABBREVIATED V) QED Page 166 QED FUNCTION - THE VERIFY SUBCOMMAND CONTROLS WHETHER OR NOT CHANGES IN THE SETTING OF THE CURRENT LINE POINTER * OR MODIFICATIONS MADE UNDER THE CHANGE SUBCOMMAND WILL BE VERIFIED. SYNTAX - VERIFY ON/OFF REQUIRED - NONE DEFAULTS - ON ALIAS- V OPERANDS - ON - SPECIFIES THAT EACH TIME THE POSITION OF THE CURRENT LINE POINTER * CHANGES, THE LINE TO WHICH IT MOVES SHOULD BE PRINTED, EXCEPT IN THOSE CASES WHEN THAT LINE IS ALREADY PRINTED IMMEDIATELY PRIOR TO THE CHANGE. IN ADDITION, MODIFICATIONS MADE IN FIELDS OF RECORDS USING THE 'CHARACTER-STRING' OR 'TEXT' FORMS OF THE CHANGE SUBCOMMAND ARE VERIFIED. OFF - CHANGES OF THE POSITION OF THE CURRENT LINE POINTER *, AND OF FIELDS OF RECORDS BY MEANS OF THE CHANGE SUBCOMMAND, ARE NOT TO BE VERIFIED. SUBCOMMAND WHERE FUNCTION - THE WHERE SUBCOMMAND DISPLAYS THE BEGINNING COLUMN NUMBERS FOR EACH OCCURENCE OF A PARTICULAR CHARACTER STRING IN A LINE. SYNTAX - WHERE 'LINE-SPEC' 'STRING' REQUIRED: 'STRING'. DEFAULTS: 'LINE-SPEC' DEFAULTS TO THE CURRENT LINE POINTER. OPERANDS - 'LINE-SPEC' - SPECIFIES THE LINE FOR WHICH THE STRING LOCATIONS ARE TO BE DISPLAYED. 'STRING' - SPECIFIES THE CHARACTER STRING WHOSE LOCATIONS ARE TO BE DISPLAYED. QED Page 167 QED SUBCOMMAND DLIM FUNCTION - SPECIFY A LOGICAL LINE DELIMITER FOR THIS TSO SESSION. MULTIPLE TSO TERMINAL INPUT LINES MAY BE ENTERED ON A SINGLE LINE IF THEY ARE SEPARATED BY THE CHARACTER SPECIFIED HERE. NOTE THAT THE DLIM CHARACTER SPECIFIED HERE WILL BE HONORED ONLY BY THE QED COMMAND. THE DLIM CHARACTER MAY BE SPECIFIED ONCE AND WILL REMAIN IN EFFECT FOR MULTIPLE QED SESSIONS DURING THIS TSO SESSION. SYNTAX - DLIM 'DELIMITER CHARACTER' OPERANDS - 'DELIMITER CHARACTER' - THE SINGLE CHARACTER WHICH IS TO SERVE AS THE LOGICAL LINE DELIMITER. NOTE : DLIM WITH NO OPERANDS WILL REMOVE ANY PREVIOUSLY ESTABLISHED DELIMITER CHARACTER. SUBCOMMAND GTAB FUNCTION - SPECIFY THE DEFAULT INPUT TAB SETTINGS FOR SPECIFIC QED DATA SET TYPES. THE DEFAULT TAB SETTIGS ESTABLISHED HERE WILL REMAIN IN EFFECT FOR THE DURATION OF THIS TSO SESSION OR UNTIL ANOTHER GTAB COMMAND IS ENTERED. THIS COMMAND CAN ALSO SPECIFY A USER DEFINED TAB CHARACTER TO BE RECOGNIZED BY QED AS THE TAB CHARACTER. SYNTAX - GTAB ON(T1,T2,...)/OFF QUAL(Q1,Q2,...) TABC('TABULATION CHARACTER'/HT) REQUIRED : NONE DEFAULTS : NONE OPERANDS - ON(T1,T2,...) SPECIFIES THE DESIRED SEQUENCE OF COLUMN NUMBERS FOR THE DEFAULT TAB SETTINGS. THE COLUMN NUMBERS MUST BE SPECIFIED QED Page 168 QED IN ASCENDING ORDER AND A MAXIMUM OF 31 SETTINGS WILL BE ACCEPTED. OFF SPECIFIES THAT ALL DEFAULT TAB SETTINGS PREVIOUSLY ESTABLISHED BY THE GTAB COMMAND ARE TO BE DELETED. QUAL(Q1,Q2,...) SPECIFIES THE LIST OF QED DATA SET TYPES TO WHICH THE DEFAULT TAB SETTINGS ARE TO APPLY. THE TYPES WHICH CAN BE SPECIFIED HERE ARE THE SAME AS THOSE WHICH CAN BE SPECIFIED IN THE QED COMMAND, WITH THE EXCEPTION THAT THE TYPE 'NULL' CAN BE SPECIFIED HERE TO INDICATE THAT THE DEFAULT TAB SETTINGS ARE TO APPLY TO DATA SETS WHOSE TYPE IS NOT SPECIFIED IN THE QED COMMAND. TABC('TABULATION CHARACTER') SPECIFIES THE SINGLE CHARACTER WHICH IS TO BE INTERPRETED BY QED AS A TAB CHARACTER. THIS CHARACTER WILL REMAIN IN EFFECT FOR THE REMAINDER OF THIS TSO SESSION OR UNTIL ANOTHER GTAB COMMAND WITH THE TABC OPERAND IS SPECIFIED. TABC(HT) SPECIFIES THAT THE STANDARD HORIZONTAL TAB CHARACTER IS TO BE USED AS THE QED TAB CHARACTER. THIS CHARACTER IS NORMALLY THE QED TAB CHARACTER UNLESS AN ALTERNATE TAB CHARACTER HAS BEEN DEFINED WITH THE GTAB COMMAND. SUBCOMMAND SCLR FUNCTION - SPECIFY THE CHARACTER STRING (IN HEXADECIMAL) WHICH WILL CLEAR THE SCREEN ON A CATHODE RAY TUBE (CRT) TERMINAL. THIS INFORMATION WILL BE USED BY VARIOUS TSO COMMANDS TO CONTROL THE FORMAT OF OUTPUT WHICH IS SENT TO THE TERMINAL. THE COMMANDS WHICH SUPPORT THIS INFORMATION WILL GENERALLY SEND THE STRING TO THE TERMINAL AT THE START OF EACH FULL SCREEN OF OUTPUT (SEE THE SCREEN COMMAND). THIS WILL CAUSE EACH NEW SCREEN FULL OF OUTPUT TO BEGIN AT THE TOP OF THE SCREEN. THE FOLLOWING COMMANDS CURRENTLY MAKE USE OF THE SCLR STRING : QED. SYNTAX - SCLR STRING('HEXADECIMAL-CHARACTER-STRING') ON/OFF QED Page 169 QED IDLES('NUMBER-OF-IDLES') NOW REQUIRED : NONE DEFAULTS : ON OPERANDS - STRING('HEXADECIMAL-CHARACTER-STRING') SPECIFIES THE CHARACTER STRING WHICH IS TO BE SENT TO CLEAR THE SCREEN ON THE TERMINAL. FOR A LISTING OF THE SCLR CHARACTER STRINGS FOR SOME SPECIFIC TERMINALS, ENTER THE TSO COMMAND 'HELP STRINGS'. ON SPECIFIES THAT THE SCLR STRING SHOULD NOW BE USED TO CLEAR THE SCREEN. THIS OPERAND CAN BE USED TO RESUME SCREEN CLEARING WHICH HAS BEEN SUSPENDED WITH THE OFF OPERAND OF A PREVIOUS SCLR COMMAND. OFF SPECIFIES THAT SCREEN CLEARING SHOULD BE SUSPENDED. IDLES('NUMBER-OF-IDLES') - SPECIFIES THE NUMBER OF IDLE CHARACTERS TO BE SENT AFTER THE SCREEN CLEAR STRING. SOME TERMINALS REQUIRE A SMALL AMOUNT OF TIME FOR THEIR SCREEN TO CLEAR. THIS OPERAND ALLOWS THE USER TO REQUEST THE CORRECT NUMBER OF IDLES FOR HIS PARTICULAR TERMINAL. SOME TERMINALS DO NOT REQUIRE ANY IDLES. ENTER HELP STRINGS FOR MORE INFORMATION ABOUT IDLES REQUIRED FOR SPECIFIC TERMINALS. NOW - SPECIFIES THAT THE SCREEN IS TO BE CLEARED NOW BY THE SCLR COMMAND. THIS FACILITY CAN BE USED IN A COMMAND PROCEDURE TO CLEAR THE SCREEN FOR A SUBSEQUENT APPLICATION PROGRAM. SUBCOMMAND SCREEN FUNCTION - SPECIFY THE NUMBER OF ROWS AND COLUMNS ON A CATHODE RAY TUBE (CRT) TERMINAL. THE INFORMATION SUPPLIED HERE WILL BE USED BY VARIOUS TSO QED Page 170 QED COMMANDS TO CONTROL THE FORMAT OF OUTPUT WHICH IS SENT TO THE TERMINAL. THE COMMANDS WHICH SUPPORT THE SCREEN INFORMATION WILL GENERALLY SEND ONE SCREEN FULL OF DATA AND THEN PAUSE SO THAT THE USER MAY ENTER A NULL LINE (TO INDICATE THAT ANOTHER FULL SCREEN OF OUTPUT IS DESIRED ) OR ENTER ANY OTHER SUBCOMMAND OF THE COMMAND. THE FOLLOWING COMMANDS CURRENTLY MAKE USE OF THE SCREEN INFORMATION : QED. SYNTAX - SCREEN ROWS('ROWS') COLS('COLUMNS') ON/OFF TRUNC/NOTRUNC REQUIRED : NONE DEFAULTS : ON OPERANDS - ROWS('ROWS') SPECIFIES THE NUMBER OF ROWS ON THE SCREEN. A SPECIFICATION OF THE SCREEN COMMAND WHICH DOES NOT INCLUDE THE ROWS OPERAND WILL HAVE NO EFFECT ON THE PREVIOUS ROWS SETTING. COLS('COLUMNS') SPECIFIES THE NUMBER OF COLUMNS ON THE SCREEN. THIS VALUE IS USED ONLY IF THE TRUNC OPERAND IS SPECIFIED. A SPECIFICATION OF THE SCREEN COMMAND WHICH DOES NOT INCLUDE THE COLS OPERAND WILL HAVE NO EFFECT ON THE PREVIOUS COLS SETTING. ON SPECIFIES THAT THE SCREEN INFORMATION IS TO TAKE EFFECT IMMEDIATELY. THIS OPERAND MAY BE USED TO RESUME SCREEN ACTIVITY AFTER IT HAS BEEN SUSPENDED WITH THE OFF OPERAND OF A PREVIOUS SCREEN COMMAND. OFF SPECIFIES THAT SCREEN PROCESSING IS TO BE SUSPENDED. TRUNC SPECIFIES THAT OUTPUT LINES ARE TO BE TRUNCATED TO THE LENGTH SPECIFIED IN THE COLS OPERAND. QED Page 171 QED NOTRUNC SPECIFIES THAT SCREEN PROCESSING IS NOT TO INCLUDE THE TRUNCATION OF OUTPUT LINES. SUBCOMMAND STRINGS THIS IS A LIST OF SPECIFIC CATHODE RAY TUBE (CRT) TERMINALS AND THE SCREEN CLEAR STRINGS FOR THEM. THE STRINGS LISTED HERE ARE THE ONES WHICH MUST BE SPECIFIED IN THE SCLR COMMAND. TERMINAL STRING IDLES INFOTON VISTAR/GT 0C NONE INFOTON VISTAR/2 A11C NONE TEKTRONIX (300 BAUD) 270C 30 SUBCOMMAND SCHEDULE (MAY BE ABBREVIATED SCHED) FUNCTION - THE SCHEDULE COMMAND IS USED TO SUBMIT A JOB TO HASP TO RUN IN THE BATCH STREAM (BACKGROUND). SYNTAX - SCHEDULE'DSLIST' NUM/NONUM RANGE('N','M') FETCH INFORM SCAN REQUIRED - NONE DEFAULTS - 'DSLIST' DEFAULTS TO *. NUM IS ASSUMED. ALIASES- SCHED OPERANDS - 'DSLIST' - THE NAME OF THE DATA SET TO BE SUBMITTED, OR A LIST OF DATA SET NAMES ENCLOSED IN PARENTHESES. AN ASTERISK (*) REFERS TO THE DATA SET BEING EDITTED. NOTE - A /*ACCOUNT CARD CONTAINING THE USER'S ACCOUNT NUMBER WILL BE INSERTED AFTER EACH JOB CARD IN THE STREAM. IF THE FIRST CARD IN THE DATA SET IS NOT A JOB CARD, ONE WILL BE INSERTED. A RECEIPT NUMBER WILL BE ASSIGNED AS THE JOB NAME ON EVERY JOB CARD. NOTE - IF IT IS DESIRED TO SUBMIT AN EXPRESS JOB, THE FOLLOWING CARD MUST APPEAR BEFORE THE $JOB - QED Page 172 QED //EXPRESS THAT IS, TWO SLASHES IN COLUNMS 1-2, AND THE WORD 'EXPRESS' AFTER ONE OR MORE BLANKS. NUM - THE DATA SET CONTAINS SEQUENCE NUMBERS. NONUM - THE DATA SET DOES NOT CONTAIN SEQUENCE NUMBERS. RANGE('N','M') - ONLY PART OF THE DATA SET IS TO BE SUBMITTED. 'N' - THE SEQUENCE NUMBER OF THE FIRST LINE TO BE SUBMITTED. 'M' - THE SEQUENCE NUMBER OF THE LAST LINE TO BE SUBMITTED. FETCH - OUTPUT FROM THE JOB IS TO BE PLACED IN THE FETCH QUEUE. THIS HAS THE SAME EFFECT AS /*JOBPARM QUEUE=FETCH INFORM- THE TSO USER IS TO BE NOTIFIED BY HASP WHEN THE JOB HAS FINISHED EXECUTION (A MESSAGE WILL APPEAR AT THE TERMINAL). SCAN - THE JCL STATEMENTS IN THE JOB STREAM ARE TO BE CHECKED FOR VALID SYNTAX, BUT THE JOB IS NOT TO BE EXECUTED. COMMAND NAME - RECOVER FUNCTION - THE RECOVER COMMAND IS USED TO RETRIEVE DATA SETS FROM THE ASM-2 BACKUP TAPES, PREVIOUSLY CATALOGED ON THE BACKUP CATALOG. SINCE A JOB IS SCHEDULED EACH TIME THE RECOVER COMMAND IS ISSUED, IF YOU WISH TO RECOVER SEVERAL DATA SETS, THE RECOVER COMMAND SHOULD BE ENTERED ONCE FOR ALL OF THEM. SYNTAX - RECOVER'LIST-OF-DATA-SETS' REQUIRED - 'LIST-OF-DATA-SETS' NOTE- THE RECOVER COMMAND PROCESSOR DOES NOT ACTUALLY PERFORM RECOVER Page 173 RECOVER THE RETRIEVAL OPERATION; IT SCHEDULES A BACKGROUND JOB INSTEAD. WHEN THE JOB HAS EXECUTED, YOU MAY USE THE FETCH COMMAND TO EXAMINE THE JOB'S OUTPUT. NOTE - TO MINIMIZE TAPE MOUNTING, PLEASE ENTER AS MANY DATA SET NAMES AS POSSIBLE, FOR THE RECOVER COMMANDS YOU GIVE. OPERANDS - 'LIST-OF-DATA-SETS' - A LIST OF DATA SETS TO BE RECOVERED,SEPARATED BY BLANKS. THE $BI COMMAND MAY BE USED TO FIND ALL VERSIONS OF THE DATA SETS TO BE RECOVERED. IF ONLY THE DATA SET NAME IS GIVEN IN THE 'LIST-OF-DATA-SETS', THE MOST RECENT VERSION IS RECOVERED. HOWEVER, IF YOU WISH TO RECOVER A VERSION FROM A PREVIOUS LEVEL OF BACKUP, THIS CAN BE ACCOMPLISHED BY USING THE FORM DSNAME(-LEVEL) IN THE DATA SET LIST. THUS, THE ENTRY DSNAME(-1) WOULD RECOVER THE VERSION BACKED UP ONE LEVEL BEFORE THE MOST RECENT BACKUP. COMMAND NAME - REGISTER FUNCTION - THE REGISTER COMMAND IS USED TO ASSOCIATE A FACULTY MEMBER WITH A SPECIFIC COURSE. THE REGISTER COMMAND MUST BE USED PRIOR TO REQUESTING A ROSTER LISTING OR USING THE STUDENTS OPTION OF THE ACF COMMAND. ONLY FACULITY MEMBERS ARE ALLOWED TO USE THE REGISTER COMMAND THEMSELVES. IF IT IS NECESSARY FOR OTHER USERS TO BE ASSOCIATED WITH A COURSE, SEE THE COMPUTER CENTER ACCOUNTING CLERK. SYNTAX - REGISTER 'CALL NUMBER' USER('USER NUMBER') REQUIRED - 'CALL NUMBER' (5 DIGITS) DEFAULTS - USER(MASTER ID OF CURRENT USER) REGISTER Page 174 REGISTER OPERANDS - 'CALL NUMBER' - THE FIVE DIGIT (LEADING ZEROS SPECIFIED) COURSE CALL NUMBER AS LISTED IN THE CURRENT QUARTER'S TIMETABLE. USER -THE UNIQUE MASTER ID OF THE USER TO BE ASSOCIATED WITH THE CALL NUMBER SPECIFIED. NOTE: THIS PARAMETER IS VALID ONLY FOR AUTHORIZED USERS. 'USER NUMBER' - MASTER ID OF USER TO BE ASSOCIATED WITH COURSE COMMAND NAME - RELEASE FUNCTION - THE RELEASE COMMAND IS USED TO RELEASE UNUSED SPACE FROM A DATA SET. SYNTAX - RELEASE 'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE OPERANDS - 'DSNAME' - THE DATA SET NAME. FOR FULLY QUALIFIED DATA SET NAMES ENCLOSE THE DSNAME IN QUOTES. COMMAND NAME - RELOAD FUNCTION - THE RELOAD COMMAND IS USED TO RETRIEVE DATA SETS FROM THE ASM-2 ARCHIVE TAPES, PREVIOUSLY CATALOGED ON THE ARCHIVE CATALOG. SINCE A JOB IS SCHEDULED EACH TIME THE RELOAD COMMAND IS ISSUED, IF YOU WISH TO RELOAD SEVERAL DATA SETS, THE RELOAD COMMAND SHOULD BE ENTERED ONCE FOR ALL OF THEM. RELOAD Page 175 RELOAD SYNTAX - RELOAD'LIST-OF-DATA-SETS' REQUIRED - 'LIST-OF-DATA-SETS' NOTE- THE RELOAD COMMAND PROCESSOR DOES NOT ACTUALLY PERFORM THE RETRIEVAL OPERATION; IT SCHEDULES A BACKGROUND JOB INSTEAD. WHEN THE JOB HAS EXECUTED, YOU MAY USE THE FETCH COMMAND TO EXAMINE THE JOB'S OUTPUT. NOTE - TO MINIMIZE TAPE MOUNTING, PLEASE ENTER AS MANY DATA SET NAMES AS POSSIBLE, FOR THE RELOAD COMMANDS YOU GIVE. OPERANDS - 'LIST-OF-DATA-SETS' - A LIST OF DATA SETS TO BE RELOADED,SEPARATED BY BLANKS. THE $AI COMMAND MAY BE USED TO FIND ALL VERSIONS OF THE DATA SETS TO BE RELOADED. IF ONLY THE DATA SET NAME IS GIVEN IN THE 'LIST-OF-DATA-SETS', THE MOST RECENT VERSION IS RELOADED. HOWEVER, IF YOU WISH TO RELOAD A VERSION FROM A PREVIOUS LEVEL OF ARCHIVE, THIS CAN BE ACCOMPLISHED BY USING THE FORM DSNAME(-LEVEL) IN THE DATA SET LIST. THUS, THE ENTRY DSNAME(-1) WOULD RELOAD THE VERSION ARCHIVED ONE LEVEL BEFORE THE MOST RECENT ARCHIVE. COMMAND NAME - RENAME FUNCTION - THE RENAME COMMAND IS USED TO RENAME A DATA SET OR A PARTITIONED DATA SET MEMBER OR TO CREATE AN ALIAS FOR A PARTITIONED DATA SET MEMBER. SYNTAX - RENAME 'DSNAME1' 'DSNAME2' ALIAS REQUIRED - 'DSNAME1' AND 'DSNAME2' DEFAULTS - NONE OPERANDS - 'DSNAME1'- THE CURRENT DATA SET NAME. 'DSNAME2'- THE NEW DATA SET NAME TO BE ASSIGNED. RENAME Page 176 RENAME ALIAS- MEMBER NAME SPECIFIED BY 'DSNAME2' IS TO BE AN ALIAS RATHER THAN A REPLACEMENT. COMMAND NAME - RETRY FUNCTION - THE RETRY COMMANDS ALLOWS MODIFICATION AND/OR RESUBMITTAL OF THE LAST 5 TSO COMMANDS THAT WERE ENTERED PREVIOUS TO RETRY. NOTE: RETRY CAN NOT MODIFY ANY COMMAND WHICH EITHER WAS A SUB COMMAND OF ANOTHER TSO COMMAND OR WAS ENTERED WITH INVALID COMMAND NAME SYNTAX. SYNTAX - RETRY 'CMDNUM' LIST EXEC ALIAS - RE DEFAULTS - IF 'CMDNUM' IS OMITTED, THE MOST RECENT COMMAND IS RETRIED. OPERANDS - 'CMDNUM' - THE GENERATION NUMBER (-1 TO -5) OF THE COMMAND YOU WISH TO RETRY. LIST - IF SPECIFIED, 5 PREVIOUS COMMANDS ARE PRINTED EXEC - IF SPECIFIED, THE CHOSEN COMMAND GENERATION IS SUBMITTED IMMEDIATELY, WITHOUT MODIFICATION. EXAMPLES - SEVERAL TYPES OF ALTERATIONS CAN BE GIVEN IN RESPONSE TO THE 'ALTERS ?' PROMPT. AFTER AN ALTERATION HAS BEEN MADE, RETRY WILL TYPE A COPY OF THE ALTERED LINE AS IT NOW STANDS AND PROMPT FOR FURTHER ALTERATIONS. A CARRIAGE RETURN IMMEDIATELY AFTER THE PROMPT WILL CAUSE THE CURRENT COPY TO BE SUBMITTED AS A TSO RETRY Page 177 RETRY COMMAND. STRIKING THE ATTENTION KEY AT ANY TIME WILL CAUSE TERMINATION OF THE COMMAND WITHOUT FURTHER ACTION. IF BLANK(S) ONLY ARE ENTERED, THE CURRENT COPY IS ECHOED OUT. D - DELETE CHARACTERS: CHARACTERS CAN BE DELETED FROM A LINE BY TYPING A 'D' UNDER EACH CHARACTER TO BE REMOVED. FOR EXAMPLE, D DELETES UNWANTED CHARACTERS. ALTERS ? DDDDDDDDD(CR) D DELETES CHARACTERS. ALTERS ? NOTE: BLANKS TYPED AFTER A 'D' ARE TREATED AS A 'D'. I - INSERT CHARACTERS: CHARACTERS CAN BE INSERTED INTO A LINE BY TYPING 'I' UNDERNEATH THE CHARACTER BEFORE WHICH THE INSERTION IS TO BE MADE, FOLLOWED BY THE CHARACTERS TO BE INSERTED. FOR EXAMPLE, I IS USED TO INSERT CHARACTERS. ALTERS ? INEW (CR) I IS USED TO INSERT NEW CHARACTERS. ALTERS ? NOTE: 'I' INSERTIONS CAN BE MADE IMMEDIATELY AFTER 'D' DELETIONS. R - REPLACE CHARACTERS: CHARACTERS IN A LINE CAN BE REPLACED BY ANOTHER CHARACTER STRING OF THE SAME LENGTH. TO REPLACE, TYPE AN 'R' UNDERNEATH THE FIRST CHARACTER TO BE REPLACED, FOLLOWED BY THE STRING OF REPLACEMENT CHARACTERS. FOR EXAMPLE, R DOSE REPLACEMENTS. ALTERS ? RES(CR) R DOES REPLACEMENTS. ALTERS ? NOTE: 'R' REPLACEMENTS CAN BE MADE IMMEDIATELY AFTER 'D' DELETION C - CANCEL ALTERATIONS: THE 'C' ALTERATION CHARACTER CAN BE USED TO CANCEL MODIFICATIONS AND RESTORE A LINE TO THE INITIAL STATE. FOR EXAMPLE, THIS LINE WILL BE MESSED UP. ALTERS ? DDDDDDDIIS(CR) THIS LINE IS MESSED UP. ALTERS ? C(CR) THIS LINE WILL BE MESSED UP. ALTERS ? N AND Q - SUSPEND LISTING: THE 'N' AND 'Q' ALTERATION CHARACTERS CAUSE THE RETRY COMMAND NOT RETRY Page 178 RETRY TO RETYPE THE LINE AFTER AN ALTERATION. 'Q' IS NOT COUNTED AS A CHARACTER WHILE 'N' IS COUNTED. FOR EXAMPLE, Q CAUSES THE ALTERATIONS NOT TO BE TYPED OUT. ALTERS ? QITYPING IN (CR) ALTERS ? (CR) TYPING IN Q CAUSES THE ALTERATIONS NOT TO BE TYPED OUT. ALTERS ? N RN(CR) ALTERS ? (CR) TYPING IN N CAUSES THE ALTERATIONS NOT TO BE TYPED OUT. ALTERS ? COMMAND NAME - ROSTER FUNCTION - THE ROSTER COMMAND IS USED TO PRODUCE A LISTING OF STUDENTS AND THEIR ACCOUNT NUMBERS WHO ARE ENROLLED IN A COURSE. ONLY COURSE INSTRUCTORS MAY REQUEST ROSTER LISTINGS. THE REGISTER COMMAND MUST BE USED TO ASSOCIATE AN INSTRUCTOR WITH A COURSE PRIOR TO REQUESTING A ROSTER LIST. SEE HELP REGISTER COMMAND FOR FURTHER INFORMATION. SYNTAX - ROSTER 'CALL NUMBER' PRINT('PRINT DATA SET')/SYSPRINT REQUIRED - 'CALL NUMBER' (5 DIGITS) DEFAULTS - IF NEITHER PRINT NOR SYSPRINT IS SPECIFIED THE ROSTER IS LISTED AT THE TERMINAL PRINT AND SYSPRINT ARE MUTUALLY EXCLUSIVE PARAMETERS OPERANDS - 'CALL NUMBER' - THE 5 DIGIT (LEADING ZEROS SPECIFIED) COURSE CALL NUMBER AS LISTED IN THE CURRENT QUARTER'S TIMETABLE. ROSTER Page 179 ROSTER PRINT - SPECIFIES THE ROSTER LISTING IS TO BE PLACED IN A DATA SET 'PRINT DATA SET' - THE NAME OF THE DATA SET INTO WHICH THE ROSTER LISTING IS TO BE PLACED SYSPRINT - SPECIFIES THE ROSTER LISTING IS TO BE PRINTED ON THE OFFLINE PRINTER COMMAND NAME - ROUTE FUNCTION - THE ROUTE COMMAND IS USED TO REDIRECT JOBS IN THE BACKGROUND QUEUES. SYNTAX - ROUTE JOB('JOB-ID') OUTPUT('DEST')/FETCH/PURGE(PRINT/NOPRINT) REQUIRED - JOB('JOB-ID') DEFAULTS - OUTPUT - IF PURGE IS SPECIFIED WITHOUT A SUBFIELD, NOPRINT IS ASSUMED. OPERANDS - JOB('JOB-ID') - SPECIFIES WHICH JOB IS TO BE AFFECTED. 'JOB-ID' IS THE JES2 NUMBER OF THE JOB NAME (RECEIPT NUMBER). OUTPUT('DEST') - THE JOB'S OUTPUT IS NOT TO BE HELD FOR FETCH PROCESSING. THIS NULLIFIES THE EFFECT OF THE FETCH KEYWORD OF THE SCHEDULE COMMAND. 'DEST' - THE DESTINATION(S) TO WHICH THE OUTPUT IS TO BE ROUTED. FETCH - THE JOB'S OUTPUT IS TO BE HELD FOR FETCH PROCESSING. THIS FUNCTION CAN BE PERFORMED IF YOU FORGET TO ENTER THE FETCH KEYWORD OF THE SCHEDULE COMMAND. PURGE(PRINT/NOPRINT) - THE JOB IS TO BE CANCELLED. PRINT SPECIFIES THAT THE JOB LOG IS TO BE PRINTED. NOPRINTSPECIFIES THAT NO OUTPUT FROM THE JOB IS TO BE PRODUCED. RULER Page 180 RULER COMMAND NAME - RULER FUNCTION - THE RULER COMMAND TYPES A LINE OF NUMBERS ON THE TERMINAL TO BE USED TO TELL WHICH COLUMN IS WHICH. SYNTAX - RULER LENGTH('N') NUM/NONUM OPERANDS - LENGTH - THE NUMBER OF COLUMNS THE LINE OF NUMBERS SHOULD EXTEND TO NUM- ALLOW FOR EDITOR LINE NUMBERS NONUM- DO NOT ALLOW FOR EDITOR LINE NUMBERS DEFAULTS LENGTH(LINESIZE) NUM COMMAND NAME - RUN FUNCTION - THE RUN COMMAND COMPILES,LOADS AND EXECUTES A SOURCE PROGRAM. SYNTAX- RUN 'DSNAME' ''PARM'' ASM/FORT/COBOL/IPLI/BASIC/GOFORT/PLI/VSBASIC LMSG/SMSG TEST/NOTEST LPREC/SPREC FIXED/FREE CHECK/OPT GO/NOGO STORE/NOSTORE PAUSE/NOPAUSE SOURCE/OBJECT LIB(DATA-SET-LIST) SIZE(VALUE) REQUIRED - 'DSNAME' NOTE - DATA SET TYPE IS REQUIRED IF THE COMPILER COMMAND CANNOT BE DETERMINED FROM THE SPECIFIED DATA SET NAME. LIB IS VALID ONLY FOR PLI WITH OPT, ASM, FORT AND COBOL DEFAULTS - OPT IS THE DEFAULT OPTION FOR THE PLI COMPILER - GO, NOSTORE, NOPAUSE, NOTEST, AND SOURCE ARE THE DEFAULT OPTIONS FOR THE VSBASIC PROGRAM PRODUCT ALIAS- R OPERANDS- 'DSNAME' RUN Page 181 RUN - NAME OF SEQUENTIAL OR PARTITIONED DATA SET WHICH CONTAINS SOURCE CODE TO BE ASSEMBLED OR COMPILED. IF DATA SET IS PARTITIONED THE MEMBER NAME CAN BE GIVEN. ''PARM'' - A PARAMETER STRING OF UP TO 100 CHARACTERS ENCLOSED IN SINGLE QUOTES TO BE PASSED TO THE PROGRAM BEING EXECUTED AS DESCRIBED UNDER THE TOPIC 'PROGRAM MANAGEMENT' IN SECTION I OF THE 'SUPERVISOR SERVICES AND MACRO INSTRUCTIONS' MANUAL. ASM - THE ASSEMBLER(F) COMPILER IS INVOKED LIB (DATA-SET-LIST) - SPECIFIES THE LIST OF DATA SETS THAT CONTAIN MODULES TO RESOLVE EXTERNAL REFERENCES COBOL - THE ANS COBOL PROGRAM PRODUCT IS INVOKED LIB (DATA-SET-LIST) - SPECIFIES THE LIST OF DATA SETS THAT CONTAIN MODULES TO RESOLVE EXTERNAL REFERENCES FORT - THE FORTRAN IV (GI) PROGRAM PRODUCT IS INVOKED LIB (DATA-SET-LIST) - SPECIFIES THE LIST OF DATA SETS THAT CONTAIN MODULES TO RESOLVE EXTERNAL REFERENCES PLI - THE PLI PROGRAM PRODUCT IS INVOKED CHECK - SPECIFIES THE PLI CHECKOUT COMPILER OPT - SPECIFIES THE PLI OPTIMIZING COMPILER (DEFAULT) LIB (DATA-SET-LIST) - SPECIFIES THE LIST OF DATA SETS THAT CONTAIN MODULES TO RESOLVE EXTERNAL REFERENCES IPLI - THE ITF:PL/I PROGRAM PRODUCT IS INVOKED LMSG - LONG FORM DIAGNOSTIC MESSAGES PROVIDED SMSG - SHORT FORM DIAGNOSTIC MESSAGES PROVIDED TEST - TESTING OF PROGRAM TO BE PERFORMED NOTEST - TEST FUNCTION NOT DESIRED BASIC - THE ITF:BASIC PROGRAM PRODUCT IS INVOKED TEST - TESTING OF PROGRAM TO BE PERFORMED NOTEST - TEST FUNCTION NOT DESIRED LMSG - LONG FORM DIAGNOSTIC MESSAGES PROVIDED SMSG - SHORT FORM DIAGNOSTIC MESSAGES PROVIDED LPREC - LONG PRECISION CALCULATIONS REQUIRED BY PROGRAM SPREC - SHORT PRECISION CALCULATIONS REQUIRED BY PROGRAM RUN Page 182 RUN VSBASIC- THE VSBASIC PROGRAM PRODUCT IS INVOKED LPREC - LONG PRECISION CALCULATIONS REQUIRED BY PROGRAM SPREC - SHORT PRECISION CALCULATIONS REQUIRED BY PROGRAM TEST - TESTING OF PROGRAM TO BE PERFORMED NOTEST - TEST FUNCTION NOT DESIRED GO - THE PROGRAM IS TO RECEIVE CONTROL AFTER COMPILATION NOGO - THE PROGRAM WILL NOT RECEIVE CONTROL AFTER COMPILATION STORE - THE COMPILER IS TO STORE THE OBJECT NOSTORE - THE COMPILER IS NOT TO STORE THE OBJECT PAUSE - THE COMPILER IS TO PROMPT BETWEEN PROGRAM CHAINS NOPAUSE - NO PROMPTING BY THE COMPILER BETWEEN PROGRAM CHAINS SOURCE - THE INPUT TO THE COMPILER IS SOURCE CODE OBJECT - THE INPUT TO THE COMPILER IS OBJECT CODE SIZE (VALUE) - THE NUMBER OF THOUSAND-BYTE BLOCKS OF USER AREA WHERE VALUE IS AN INTEGER OF 1-3 DIGITS GOFORT - THE CODE AND GO FORTRAN PROGRAM PRODUCT IS INVOKED LMSG - LONG FORM DIAGNOSTIC MESSAGES PROVIDED SMSG - SHORT FORM DIAGNOSTIC MESSAGES PROVIDED FIXED - SOURCE STATEMENTS ADHERE TO STANDARD FORTRAN COLUMN REQUIREMENTS FREE - SOURCE STATEMENTS ARE FREE FORM NOTE - IF THE RIGHT MOST QUALIFIER OF THE DATA SET NAME IS THE SAME AS THE COMPILER TYPE OPERAND,THE COMPILER TYPE OPERAND IS NOT NEEDED. GOFORT IS NOT A VALID QUALI- FIER. FORT IS APPENDED WHEN PROCESSING GOFORT COMMAND. COMMAND NAME - SAS76 Function - SAS76 invokes the Statistical Analysis System, Version 76.4. THE USER IS PROMPTED FOR INFORMATION REGARDING THE ALLOCATION OF NECESSARY FILES. THE FIRST PROMPT ASKS ABOUT BASIC FILE ALLOCATION. THE SECOND CONCERNS ALLOCATIONS FOR SORT/MERGE FACILITIES. THE USER MAY REPLY YES OR NO. AT THE END THE USER IS PROMPTED FOR A REPLY TO FREE THE ALLOCATED FILES. Syntax - SAS76 'dsname1 | *' OPTIONS('list') OUTPUT(dsn) WORK(ntrks) SAS76 Page 183 SAS76 SORTWORK(ntrks) Required: dsname1 or * Defaults: OUTPUT(*) WORK(10) SORTWORK(10) Note : The usage of the SAS76 command does NOT conform to that described in 'A User's Guide to SAS76'. The commands SASSORT and SASGO have been replaced by the prompts for file allocation in our SAS76 command. Other documented SAS76 usage information is correct. Operands - dsname1 | * - Name of the data set containing SAS76 statements. If '*' is specified, statements are entered from the terminal. If 'dsname1' is specified, SAS will first perform the operations requested by the statements in 'dsname1'. After all such statements are processed, control is returned to the terminal. OPTIONS('list') - List of options to be passed to SAS76. This may be specified OPTIONS(SYSIN=IN) when using an edited dataset as the source instead of having SAS prompt for lines from the terminal. If (*) is concatenated to IN, prompts will be given after the 1st line of input from the terminal. Any other valid SAS options may also be specified here. The OPTIONS list is enclosed in single quotes. OUTPUT(dsn) - The file where the printout from the procedures is to be routed. This defaults to the terminal. WORK(ntrks) - The number of tracks which are allocated for the temporary SAS76 work file. (Ten secondary tracks are always requested.) SORTWORK(ntrks) - The number of tracks which are allocated for the sort files. May be increased if the default (10) is not sufficient. SAS79 Page 184 SAS79 COMMAND NAME - SAS79 Function - SAS79 invokes the Statistical Analysis System, Version 79.6. THE USER IS PROMPTED FOR INFORMATION REGARDING THE ALLOCATION OF NECESSARY FILES. THE FIRST PROMPT ASKS ABOUT BASIC FILE ALLOCATION. THE USER MAY REPLY YES OR NO. AT THE END THE USER IS PROMPTED FOR A REPLY TO FREE THE ALLOCATED FILES. Syntax - SAS79 'dsname1 | *' OPTIONS('list') OUTPUT(dsname2) WORK(ntrks) LIBRARY(dsname3) Required: dsname1 or * Defaults: OUTPUT(*) WORK(10) Note : The usage of the SAS79 command does NOT conform to that described in 'A User's Guide to SAS79'. The command SASGO has been replaced by the prompts for file allocation in our SAS79 command. Other documented SAS79 usage information is correct. Operands - dsname1 | * - Name of the data set containing SAS79 statements. If '*' is specified, statements are entered from the terminal. If 'dsname1' is specified, SAS will first perform the operations requested by the statements in 'dsname1'. After all such statements are processed, control is returned to the terminal. OPTIONS('list') - List of options to be passed to SAS79. This may be specified OPTIONS(SYSIN=SASIN) when using an edited dataset as the source instead of having SAS prompt for lines from the terminal. If (*) is concatenated to IN, prompts will be given after the 1st line of input from the terminal. Any other valid SAS options may also be specified here. The OPTIONS list is enclosed in single quotes. OUTPUT(dsname2) - The file where the printout from the procedures is to be routed. This defaults to the terminal. SAS79 Page 185 SAS79 WORK(ntrks) - The number of tracks which are allocated for the temporary SAS79 work file. (Ten secondary tracks are always requested.) LIBRARY(dsname3) - Data set containing formats stored using PROC FORMAT created via a batch job or prior allocation. New formats may NOT be added to this data set during the session utilizing it. COMMAND NAME - SCHEDULE FUNCTION - THE SCHEDULE COMMAND IS USED TO SUBMIT A JOB TO JES2 TO RUN IN THE BATCH STREAM (BACKGROUND). SYNTAX - SCHEDULE'DSLIST' NUM/NONUM RANGE('N','M') FETCH INFORM SCAN NOFREE JOBPARM('STRING') OUTPUT('DEST') NOPROMPT REQUIRED - 'DSLIST' DEFAULTS - NUM ALIASES- SCHED OPERANDS - 'DSLIST' - THE NAME OF THE DATA SET TO BE SUBMITTED, OR A LIST OF DATA SET NAMES ENCLOSED IN PARENTHESES. AN ASTERISK (*) INDICATES THAT INPUT WILL COME FROM THE TERMINAL, OR FROM THE DATA SET CURRENTLY BEING EDITTED IF SCHEDULE IS USED AS A SUBCOMMAND OF EDIT OR QED. NOTE - A NULL LINE INDICATES THE END OF TERMINAL INPUT. USE &STR() TO INDICATE END OF DATA IN A CLIST. NOTE - A /*ACCOUNT CARD CONTAINING THE USER'S ACCOUNT NUMBER WILL BE INSERTED AFTER EACH JOB CARD IN THE STREAM. IF THE FIRST CARD IN THE DATA SET IS NOT A JOB CARD, ONE WILL BE INSERTED. A RECEIPT NUMBER WILL BE ASSIGNED AS THE JOB NAME ON EVERY JOB CARD. NOTE - IF IT IS DESIRED TO SUBMIT AN EXPRESS JOB, THE FOLLOWING LINE MUST APPEAR BEFORE ANY BUT THE FIRST $JOB - //EXPRESS THAT IS, TWO SLASHES IN COLUNMS 1-2, AND THE WORD 'EXPRESS' AFTER ONE OR MORE BLANKS. SCHEDULE Page 186 SCHEDULE NOTE - IF THE FIRST LINE OF THE DATA SET BEGINS WITH 'LOGON', APPROPRIATE JCL WILL BE SUPPLIED FOR EXECUTING TSO COMMANDS IN THE BACKGROUND. NUM - THE DATA SET CONTAINS SEQUENCE NUMBERS. NONUM - THE DATA SET DOES NOT CONTAIN SEQUENCE NUMBERS. RANGE('N','M') - ONLY PART OF THE DATA SET IS TO BE SUBMITTED. 'N' - THE SEQUENCE NUMBER OF THE FIRST LINE TO BE SUBMITTED. 'M' - THE SEQUENCE NUMBER OF THE LAST LINE TO BE SUBMITTED. FETCH - OUTPUT FROM THE JOB IS TO BE PLACED IN THE FETCH QUEUE. THIS HAS THE SAME EFFECT AS /*JOBPARM QUEUE=FETCH INFORM- THE TSO USER IS TO BE NOTIFIED BY JES2 WHEN THE JOB HAS FINISHED EXECUTION (A MESSAGE WILL APPEAR AT THE TERMINAL). SCAN - THE JCL STATEMENTS IN THE JOB STREAM ARE TO BE CHECKED FOR VALID SYNTAX, BUT THE JOB IS NOT TO BE EXECUTED. NOFREE- A FREEALL COMMAND IS NOT TO BE EXECUTED AUTOMATICALLY. JOBPARM('STRING') - A /*JOBPARM CARD IS TO BE INSERTED IN EACH JOB. 'STRING' - A QUOTED STRING CONTAINING THE DESIRED /*JOBPARM OPTIONS. OUTPUT('DEST') - THE JOB'S OUTPUT IS TO BE ROUTED TO THE REMOTE WORK STATION(S) SPECIFIED BY 'DEST'. NOPROMPT - NO PROMPTING MESSAGES ARE TO BE PRINTED WHEN THE JOB STREAM IS ENTERED AT THE TERMINAL. SCRIPT Page 187 SCRIPT COMMAND NAME - SCRIPT FUNCTION - A TSO command to execute script, a text formatting program. SYNTAX - SCRIPT 'input-dsname' ''values-list'' ADjust/NOADjust/ADjust('n')/NOCEnter/CEnter('n') BMargin('n') COntinue/NOCOntinue/COntinue('n') DArk('n') FFCHannel('m')/FFTop('n') FNSize('n') FOrmatted/UNFOrmatted HMargin('n') HSFSover('n') HYphenate/NOHYphenate LEGalnumber('n') LIBrary('data-set-name') LINenumber('n') LLength('n') LOCAL/GLOBAL MArk/NOMArk MEmo/NOMemo MESsage('data-set-name') NUmber/NONUmber/NUmber('n') OFfline ONline/TErminal PAge('m')/PAge('m':'n') PASses('n')/ONEPass/TWOPass PAUse/PAUse1/NOPAUse PLength('n') PRofile/NOPRofile PRint('data-set-name'<,T/PC/PS>) QUiet/NOQUiet RMSIze('n') SCREen/NOSCREen SEQColumn('n') SIX/EIGHT SRlength('n') STATistics/NOSTATistics STop/NOSTop SYscons('data-set-name') TABLeft('n') TMargin('n') TRanslate/NOTRanslate/UPcase/NOUPcase SCRIPT Page 188 SCRIPT UPPer/NOUPPer WAit/NOWAit REQUIRED - 'input-dsname' DEFAULTS NOADJUST,NOCONTINUE,CHANNEL(1),DOWN(64),FORMATTED, FNSIZE(200),HSFSOVER(9),NOHYPHENATE LINUMBER(0),LOCAL,NOMARK,NOMEMO,MESSAGE(*),NONUMBER,PAGE(1:32K), PASSES(1),PRINT(*),NOPROFILE,NOQUIET,NOREVERSE, RMSIZE(200),SEQCOLUMN(1),SIX,SRLENGTH(100),NOSTATISTICS, STOP,SYSCONS(*),TABLEFT(0),NOTRANSLATE,UPPER,WAIT SCREEN IS THE DEFAULT IF THE TERMINAL IS A CRT, OTHERWISE NOSCREEN. THE DETERMINATION IS BASED UPON THE VALUE OF THE SCRSIZE OPERAND OF THE TERM COMMAND. OPERANDS - 'input-dsname' - The name of data set to be used to create the document. ''values-list'' The optional second positional parameter is used to give default values to SET REFERENCE Symbols. The syntax is '+name=value +name=value &&name=value', where the APOSTROPHES ARE MANDATORY and PLUS (+) may be freely interchanged with AMPERSANDS (&&). Any numeric value which is a multiple of 1024 may be written in the form nK. If a name begins with 'NO', the operand is disabled. ADJUST ADjust / NOADjust / ADjust(<0|n>) -------- - Causes all the output to be printed up to fifty columns from the left print margin. ADJUST by itself defaults to thirty columns, but ADJUST may specify from zero to fifty columns. CENTER CENTEr / NOCENTEr / CENTEr(<0|n>) -------- - Alternate forms of ADJUST, for compatability with former versions of SCRIPT. SCRIPT Page 189 SCRIPT CENTRE CEntre / NOCEntre / CEntre(<0|n>) see ADJUST -------- - CONTINUE COntinue / NOCOntinue / COntinue(<0|n>) ---------- - Specifies the number of errors which are to be allowed before processing is terminated. The value of "n" may range from 0 to 32767; NOCO is the same as CO(0), and CO is the same as CO(32767). DEBUG / NODEBUG see SPIE ------- SPIE/ NOSPIE ---- This is a debugging tool for the person maintaining the SCRIPT program. It prevents a program interrupt exit from being set, thus preventing a SCRW999T diagnostic from occurring. FFCHANNEL FFCHannel(1|n) - The Form Feed Channel option specifies the printer channel from 1 to 9 that SCRIPT will use to align output below a page perforation. FFTOP FFTop(3|n) - The Form Feed Top option specifies the line number on the page that corresponds to the FFCHANNEL= skip on an output page. The value of this parameter may vary from line 1 to 175. SCRIPT Page 190 SCRIPT FORMATTED FOrmatted / UNformatted --------- The specified file is printed along with all control lines. No other processing takes place. FNSIZE FNSize(200|n) --- Specifies the maximum number of output lines (from 1 to 32767) that may be outstanding in a Keep or Footnote at any one time. HSFSOVER HSFSover(9|n) - Specifies the maximum number of top and bottom titles that may be defined. See the .TT control word for a description of how these titles are shared. The numeric operand may range from 2 to 19. LEGALNUMBER opposite but similiar to LINENUMBER. LINENUMBER LINenumber(0|n) / LEGalnumber(0|n) - - LIN causes the current output line number within the page to be displayed if the output line is non-blank and that portion of the output line starting at column "n" (ranging from 1 to 125) is otherwise blank. LEG numbers only non-blank lines in the text area. LIN and LEG are mutually exclusive. GLOBAL is the opposite of LOCAL LOCAL / GLOBAL ----- SCRIPT Page 191 SCRIPT Causes the parameter variables "&0", "&1", etc. to be entered in a dictionary local to the file being called or to be entered in the global dictionary. MARK MArk / NOMArk ------ Marks the beginning of each line of the original input by underscoring the first character of each record. MEMO MEmo / NOMEmo ------ When used in combination with the TErminal option, this causes output to be written to the usual offline file but in a format suitable for an online TErminal. NUMBER NUmber / NONUmber / NUmber(0|n) -------- - Displays the number of the record in the input file being processed when the current output line was printed. The value of "n" (from 1 to 100) defines the starting column in the output line where this information is to appear, if those columns would otherwise be blank. NONU is the same as NU(0). NU is the same as NU(1) with an ADjust of 30. OFFLINE OFline Causes the output to be edited and formatted for the off-line printer. ONLINE ONline or TErminal Causes output lines to be formatted for an online terminal. This option is mutually exclusive of the offline option. SCRIPT Page 192 SCRIPT PAGE PAge(1|m<:n>) - Input is processed but output is not produced until the start of page "m". If a second number "n" is specified, processing and output will terminate after page "n" has been produced. The PAGE option may be useful for restart purposes (i.e. PAGE(5)) or for checking single pages of output (i.e. PA(5:5)). PASSES PASses(1|n) - Causes SCRIPT to make "n-1" complete passes through the input file, performing all indicated formatting but not producing any output. A last pass is then made, during which output is produced. The value of "n" may range from 1 to 10. This option is useful for processing a file which uses reference variables defined later in the input. OFFLINE OFline Causes the output to be edited and formatted for the off-line printer. It is recommended that a printer be used when proof-reading the output. PROFILE PROFile / NOPROFile --------- Causes an imbed (.IM) of a file called PROFILE automatically at the start of each pass. TWOPASS TWOPass or 2Pass / ONEPass or 1Pass ------- The TWOPASS option is a shortform for PASSES(2). The ONEPASS option is a shortform for PASSES(1). SCRIPT Page 193 SCRIPT QUIET QUiet / NOQUiet ------- If TErminal is in effect, QUiet causes the SCRIPT version identification line to be suppressed. RMSIZE RMSize(200|n) --- Specifies the maximum number of input records (from 1 to 32767) that may be included in any single remote (see .RM) definition. SCREEN SCREen / NOSCREen -------- Specifies that the output device is a SCREEN or CRT device. It is effective only for TErminal output. SCREEN is set to the default if the output device is known to be a CRT. The effect is to print overstruck output on one or more consecutive lines instead of using "backspace and underscore". SEQCOLUMN SEQColumn(240|n) --- Specifies the first of eight contiguous columns (from 1 to 240) where the input record sequence number may be found for variable-length input files. SEQ(0) means that no sequence numbers are present. If "n" is greater than the length of a record, then the last eight columns are presumed to contain the sequence number for that record. SIX / EIGHT --- The SIX option defines the initial Page Length and Down values for six lines per inch on an eleven inch page. EIGHT The EIGHT option defines the initial Page Length and SCRIPT Page 194 SCRIPT Down values for eight lines per inch on an eleven inch page. SRLENGTH SRLength(150|n) --- Specifies the maximum length of character-string operands for reference variables; "n" may range from 4 to 240. STATISTICS STATistics / NOSTATistics ------------ Causes various and sundry statistics information to be printed on the MESSAGE data set. STOP STop / NOSTop ---- Causes a pause at the bottom of each page when producing online output. This pause allows the user to insert the next page. The pause is terminated by a carriage return. TABLEFT TABLeft(0|1) - Controls the operation of a Left Tab. A "0" value makes Left Tabs work like a typewriter, with the character following a tab being placed in the column specified. A "1" value makes the character following a Left Tab go immediately after the column specified. See the Tab control word (.TB). TERMINAL TErminal or ONline Causes output lines to be formatted for an online terminal. This option is mutually exclusive of the offline option. SCRIPT Page 195 SCRIPT UPCASE same as TRANSLATE UPcase / NOUPcase -------- TRANSLATE TRanslate / NOTRanslate ----------- Causes character translation using a translate table that contains as default lower to upper case mapping. Other types of translation may be specified with the .TR control word. UPPER UPPer / NOUPPer ----- The UPPER option causes all SET REFERENCE symbols to be converted to upper case before symbol table lookups. WAIT WAit / NOwait ---- Causes output to begin immediately without waiting for the first page to be positioned by the user. This option has no effect when producing off-line output. +NAME see &NAME &NAME &name=string OR +name=string At the beginning of the first pass, a ".SR name=string;" control line will be executed for each such option in the options list. See the ".SR" control word for operand format rules. This is useful for setting switch values externally to the SCRIPT input. MESSAGE('data-set-name') - Name of the data set to recieve SCRIPT error messages or output from .TY. Defaults to the terminal. SCRIPT Page 196 SCRIPT SYSCONS('data-set-name') - Name of the data set to supply input to the SCRIPT program for synchronization and for .RV and .RD. Defaults to the terminal. PRINT('data-set-name' <'output-type'>) The name of the data set to receive SCRIPT output. Default is the terminal (PRINT(*)). 'output-type' may be "T" OR "PC" OR "PS", indicating respectively that the output will eventually be listed at the terminal (TERMINAL), will be converted to capital letters for printing on a line printer (TRANSLATE + OFFLINE), or will not be converted to capital letters but will be printed on a line printer (same as NOTRANSLATE + OFFLINE). PAUSE - Same as STOP + WAIT. NOPAUSE- Same as NOSTOP + NOWAIT PAUSE1 - Same as NOSTOP + WAIT BMARGIN(6|n) - Sets the default (no operand) value for the .BM control word. Range is 0 - 33. Not less than the sum of the FM and FS values. DARK(1|n) - Sets the default (no operand) value for the .DA control word. Range is 1 - 10 FMARGIN(1|n) - Sets the default (no operand) value for the .FM control word. Range is 0 -33 SCRIPT Page 197 SCRIPT HMARGIN(1|n) - Sets the default (no operand) value for the .HM control word. Range is 0 - 33 HYPHENATE Causes the hyphenate version of the WATERLOO SCRIPT program to be executed. (may take a larger region). LIBRARY('lib-dsname') / NOLIBrary The name of partitioned data set to be searched to resolve user imbed (.IM) references. LLENGTH(60|n) -- Sets the default (no operand) value for the .LL control word. Range is 10 - 144 PLENGTH(66|n) -- Sets the default (no operand) value for the .PL control word. Range is 10 - 176 TMARGIN(6|n) - Sets the default (no operand) value for the .TM control word. Range is 0 - 33. Not less than the sum of the HM and HS values. EXAMPLE SCRIPTLETTER.TEXT CO Means format dataset LETTER.TEXT and output to the terminal. Line sequence numbers (if any) of raw input data are in columns 1-8 (normal for a text dataset). Continue processing in case of errors (up to 32767 errors). SCR LETTER.TEXT '+SHAKRAN=HENRYK' PAGE(3:7) SCRIPT Page 198 SCRIPT MEANS FORMAT DATASET LETTER.TEXT AND PRINT PAGES 3-7. THE SET REFERENCE SYMBOL &SHAKRAN IS SET TO THE VALUE HENRYK. SCR LETTER.TEXT PAGE(4:4) MEANS FORMAT DATASET LETTER.TEXT AND PRINT ONLY PAGE 4. SCSS Page 199 SCSS COMMAND NAME - SCSS FUNCTION - THE SCSS COMMAND INVOKES THE SCSS CONVERSATIONAL STATISTICAL SYSTEM (VERSION 4.2). SCSS IS DOCUMENTED IN "SCSS: A USER'S GUIDE TO THE SCSS CONVERSATIONAL SYSTEM" (1980, MCGRAW-HILL). SCSS IS THE PROPRIETARY PRODUCT OF SPSS INC., CHICAGO, ILLINOIS. DISTRIBUTION OR USE, IN WHOLE OR IN PART, EXCEPT AS LICENSED, IS FORBIDDEN. SCSS IS A FULLY CONVERSATIONAL SYSTEM WHICH PROVIDES THE FOLLOWING STATISTICAL TECHNIQUES: UNIVARIATE FREQUENCIES, HISTOGRAMS, AND STATISTICS N-WAY CROSSTABULATIONS WITH STATISTICS BREAKDOWNS OF MEANS WITH STATISTICS SCATTERPLOTS AND CASEWISE PLOTS PRODUCT MOMENT CORRELATIONS PARTIAL CORRELATIONS STEPWISE REGRESSION AND CREATION AND DISPLAY OF RESIDUALS FACTOR ANALYSIS AND CREATION OF FACTOR SCORES SCSS IS SUITED TO THE ANALYSIS OF FILES RANGING FROM VERY SMALL TO QUITE LARGE. FILES MAY CONTAIN UP TO 9,999 VARIABLES AND ANY NUMBER OF CASES. SCSS STORES THE DATA UNDER ANALYSIS IN THE FORM OF A SCSS MASTERFILE. DATA MAY BE ENTERED AT THE TERMINAL, OR MAY BE READ FROM A "RAW DATA" DATASET. SCSS MASTERFILES MAY BE READ WHICH WERE PRODUCED BY PREVIOUS SCSS SESSIONS, OR BY THE "SAVE SCSS" COMMAND IN THE SPSS BATCH SYSTEM. SEVERAL USERS MAY USE THE SAME MASTERFILE SIMULTANEOUSLY WITHOUT INTERFERING WITH EACH OTHER BY USING SCSS WORKFILES. EACH USER MAINTAINS HIS OWN WORKFILE WHICH CONTAINS ONLY NEW AND TRANSFORMED DATA; THE ORIGINAL MASTERFILE MAINTAINS ITS ORIGINAL FORM. SCSS ISSUES A PROMPT WHENEVER IT EXPECTS YOU TO ENTER SOMETHING AT YOUR TERMINAL. TO ACCEPT A DEFAULT, SIMPLY HIT THE RETURN KEY.IF YOU ANSWER "YES" TO THE INITIAL "EXPLAIN?" PROMPT, YOU WILL BE GUIDED THROUGH A FULLER EXPLANATION OF THE SYSTEM. TO RECEIVE ASSISTANCE, ENTER "/HELP". TO RECEIVE AN IN-DEPTH EXPLANATION, ENTER "/EXPLAIN". TO GET OUT OF SCSS, ENTER "/STOP".TO MOVE TO A PROMPT OTHER THAN THE CURRENT ONE, PREFIX THE FIRST WORD OF THE DESIRED PROMPT WITH A SLASH AND FOLLOW IT WITH YOUR RESPONSE THUS CREATING A COMMAND. TO LEARN ABOUT THE APPROPRIATE RESPONSE TO SUCH A COMMAND, FOLLOW THE COMMAND WITH "/HELP" IN LIEU OF THE RESPONSE AS IN "/LIST/HELP". TO FIND OUT WHAT COMMANDS ARE AVAILABLE TO YOU, USE THE "/LIST VOCABULARY" COMMAND.ADDITIONAL COMMANDS CAN BE DISCOVERED BY USING "/LIST VOCABULARY FOR CONTEXT GLOBAL". SYNTAX - SCSS SCSS Page 200 SCSS OPERANDS - NONE COMMAND NAME - SEARCH FUNCTION - THE SEARCH COMMAND IS USED TO SEARCH A PARTITIONED DATA SET FOR A SPECIFIED CHARACTER STRING. EACH RECORD THAT CONTAINS THE STRING IS DISPLAYED. MEMBERS TO BE SEARCHED CAN BE LIMITED. SYNTAX - SEARCH 'DSNAME' ''STRING'' NUM/NONUM ASIS FROM(MEMBER-SUBSTR) LIKE(MEMBER-SUBSTR) SUBS(MEMBER-SUBSTR) TO(MEMBER-SUBSTR) REQUIRED - 'DSNAME', ''STRING'' DEFAULTS - NUM OPERANDS - 'DSNAME' - THE NAME OF THE PARTITIONED DATA SET TO TO BE SEARCHED. ''STRING'' - THE QUOTED STRING TO BE SEARCHED FOR IN THE DATA SET. NUM - THE SUPPLIED DATA SET CONTAINS SEQUENCE NUMBERS. NONUM - THE SUPPLIED DATA SET DOES NOT CONTAIN SEQUENCE NUMBERS. ASIS - THE QUOTED STRING SHOULD NOT BE TRANSLATED TO UPPER CASE. FROM (MEMBER-SUBSTR) - SPECIFIES THAT MEMBERS TO BE SEARCHED MUST BE LEXICALLY GREATER THAN OR EQUAL TO THE MEMBER-SUBSTRING LIKE (MEMBER-SUBSTR) - SPECIFIES THAT MEMBERS TO BE SEARCHED MUST BEGIN WITH THE GIVEN MEMBER-SUBSTRING. SEARCH Page 201 SEARCH SUBS (MEMBER-SUBSTR) - SPECIFIES THAT MEMBERS TO BE SEARCHED MUST CONTAIN THE GIVEN MEMBER-SUBSTRING. TO (MEMBER-SUBSTR) - SPECIFIES THAT NO MEMBERS SHOULD BE SEARCHED WHICH ARE LEXICALLY GREATER THAN THE MEMBER-SUBSTRING. NOTE:'FROM', 'LIKE' AND 'SUBS' ARE MUTUALLY EXCLUSIVE. 'TO' CAN BE USED ALONE OR IN COMBINATION WITH 'FROM', 'LIKE' AND 'SUBS'. COMMAND NAME - SEND SEND FUNCTION - COMMUNICATION BETWEEN USER TERMINALS, OR BETWEEN USER TERMINAL AND OPERATOR CONSOLE. SYNTAX - SEND''TEXT'' USER('USERID LIST') NOW/LOGON/SAVE NOWAIT/WAIT OR OPERATOR('ROUTING CODE') OR CN('CONSOLE IDENTIFIER') REQUIRED - ''TEXT'' DEFAULTS - OPERATOR(2), NOW, NOWAIT ALIAS- SE NOTE - DEFAULT OF OPERATOR(2) IS FOR MASTER CONSOLE. OPERANDS - ''TEXT'' - MESSAGE TO BE SENT IN QUOTES. IF AN APOSTROPHE IS TO BE PART OF THE MESSAGE, IT MUST BE ENTERED AS 2 APOSTROPHES. USER('USERID LIST') - SPECIFIES THAT THE MESSAGE IS TO BE SENT TO THE INDICATED USER(S) ONLY. 'USERID LIST' - LIST OF USERIDS TO WHOM MESSAGE IS TO BE ROUTED. IF '*' IS SPECIFIED INSTEAD OF A USERID, THE USERID OF THE SENDER WILL BE SUBSTITUTED. NOW - SPECIFIES THAT THE MESSAGE IS TO BE SENT NOW. SEND Page 202 SEND LOGON- SPECIFIES THAT THE MESSAGE IS TO BE SENT NOW (IF USER IS CURRENTLY LOGGED ON) OR SAVED IN THE BROADCAST DATA SET UNTIL THE SPECIFIED USER LOGS ON. SAVE - SPECIFIES THAT THE MESSAGE IS TO BE SAVED IN THE BROADCAST DATA SET AND NOT SENT NOW. NOWAIT - SPECIFIES THAT THE SENDER SHOULD NOT BE KEPT WAITING IF ANY INDICATED LOGGED-ON USER CANNOT RECEIVE THE MESSAGE IMMEDIATELY. WAIT - SPECIFIES THAT THE SENDER IS WILLING TO WAIT FOR ALL INDICATED LOGGED-ON USERS TO RECEIVE THE MESSAGE. OPERATOR('ROUTING CODE') - SPECIFIES THE MESSAGE IS TO BE ROUTED TO THE OPERATOR. 'ROUTING CODE' - INTEGER SPECIFYING THE FUNCTIONAL CONSOLE TO WHICH MESSAGE IS TO BE ROUTED USING THE INTEGER AS A ROUTING CODE. CN('CONSOLE IDENTIFIER') - SPECIFIES THE MESSAGE IS TO BE SENT TO AN OPERATOR CONSOLE. 'CONSOLE IDENTIFIER' - INTEGER SPECIFYING THE CONSOLE NUMBER. THIS NUMBER IS APPENDED TO ANY MESSAGE SENT FROM AN OPERATOR CONSOLE. COMMAND NAME - SETTERM FUNCTION - THE SETTERM COMMAND IS USED TO DESCRIBE THE USER'S TERMINAL CHARACTERISTICS TO THE SYSTEM. SYNTAX - SETTERM LINE(CHAR)/LINE(CTLX)/LINE(ATTN)/LINE(LIST)/NOLINE SETTERM Page 203 SETTERM CHAR(CHAR)/CHAR(BS)/CHAR(LIST) LINESIZE('INTEGER')/LINESIZE(LIST) LINES('INTEGER')/LINES(LIST) SCRSIZE('INTEGER','INTEGER') SCRCLEAR('CHARACTER STRING')/NOCLEAR REMOTE(LOCAL)/REMOTE(BSB)/REMOTE(LIST) TERMINAL LIST TTY/ASCII/IBM2741/DEC/TIS700/GT/VISTAR/TEK/SOL/DIABLO HYTERM REQUIRED - NONE DEFAULTS - LIST FOR HELP ON TTY/ASCII/IBM2741/DEC, ETC ENTER 'HELP SETTERM OPERAND(TERMTYPE)' OPERANDS - CHAR(BS)/CHAR('CHARACTER')/CHAR(LIST) - SPECIFIES THE CHARACTER TO BE INTERPRETED AS A BACKSPACE CHARACTER OR CODE 'BS' IF THE TERMINAL HAS A BACKSPACE KEY (CNTL/H ON MANY TERMINALS). CODE 'LIST' TO LIST THE CURRENT BACKSPACE CHARACTER. LINE(CTLX)/LINE(ATTN)/LINE('CHARACTER')/LINE(LIST) - SPECIFIES THE CHARACTGER TO BE USED AS A LINE DELETE CONTROL. SPECIFY 'CTLX' IF THE CONTROL AND X KEY COMBINATION IS TO BE USED FOR LINE DELETION. SPECIFY 'ATTN' IF THE ATTENTION KEY (BREAK KEY ON SOME TERMINALS) IS TO BE USED. OR SPECIFY 'LIST' IF YOU WOULD LIKE THE CURRENT LINE DELETE CHARACTER TO BE LISTED. LINES('INTEGER')/NOLINES/LINES(LIST) - SPECIFIES THE MAXIMUM NUMBER OF LINES (MAXLINES) WHICH CAN BE PRINTED BY THE SYSTEM AT YOUR TERMINAL BEFORE A PAUSE IN THE LISTING IS ISSUED. (LISTING OF LINES CAN BE RESUMED BY PRESSING THE CARRIAGE RETURN, AFTER A PAUSE IS ISSUED.) IF THE NOLINES OPERAND IS ENTERED, ANY PREVIOUS MAXLINES PARAMETER IS RESET TO 'NONE'. (NO PAUSE IS ISSUED WHEN MAXLINES(NONE) IS IN EFFECT.) WHEN 'LIST' IS USED AS A VALUE OF LINES, THE MAXLINES PARAMETER PRESENTLY IN EFFECT IS LISTED. SETTERM Page 204 SETTERM LINESIZE('INTEGER')/LINESIZE(LIST) - SPECIFIES THE LOGICAL LINESIZE OF THE TERMINAL BEING USED. SPECIFY 'LIST' TO REQUEST THE CURRENT VALUE BE LISTED. SCRSIZE('INTEGER','INTEGER') - SPECIFIES THE SCREEN SIZE OF A DISPLAY STATION IN ROWS AND COLUMNS. THIS OPERANDS IS VALID ONLY WHEN USING AN IBM 3270 DISPLAY STATION OR EQUIVALENT. TO DETERMINE THE CURRENT SPECIFICATIONS FOR THIS OPERAND SPECIFY 'LINESIZE(LIST)'. THIS WILL CAUSE THE CURRENT SCRSIZE SPECIFICATIONS TO BE LISTED IF THIS IS A DISPLAY STATION OR LIST THE CURRENT LOGICAL LINE SIZE IF IT IS NOT. SCRCLEAR('CHARACTER STRING') - SPECIFIES THE CHARACTER STRING THAT WILL, WHEN ENTERED, CAUSE THE DISPLAY STATION SCREEN TO BE ERASED. THIS OPERAND IS VALID ONLY FOR AN IBM 3270 DISPLAY STATION OR EQUIVALENT. (NOTE: TO MAINTAIN COMPATIBILITY AND FOR FUTURE EXPANSION THE OPERAND 'SCRCLEAR(LIST)' IS INVALID AND WILL RESULT IN AN EFFECTIVE NO-OPERATION.) REMOTE(LOCAL)/REMOTE(BSB)/REMOTE(LIST) - SPECIFIES THE DEFAULT DESTINATION FOR OUTPUT FOR JOBS SCHEDULED FROM THIS TERMINAL SESSION OR FOR OUTPUT SPUN FROM THIS TERMINAL SESSION. THIS DESTINATION MAY BE OVERRIDDEN FOR A PARTICULAR JOB/SPIN BY APPROPRIATE OPERANDS ON THE ASSOCIATED COMMANDS. CAUTION: NOT ALL UICC REMOTES ARE CAPABLE OF ALL OUTPUT FORMS; BE SURE THE DESTINATION YOU SPECIFY IS CAPABLE OF HANDLING YOUR OUTPUT SPECIFICATIONS. SPECIFY 'LIST' TO DETERMINE WHAT YOUR CURRENT REMOTE DESTINATION IS. TERMINAL - CODE THE TERMINAL KEYWORD TO REQUEST THAT THE USER'S CURRENT DATASET PREFIX AND THE USER'S TERMINAL TYPE BE LISTED AT THE TERMINAL. LIST - CODE THE LIST KEYWORD TO REQUEST THAT THE FOLLOWING SETTERM Page 205 SETTERM INFORMATION BE LISTED AT THE TERMINAL: - CHARACTER DELETION CHARACTER - LINE DELETION CHARACTER - LOGICAL LINE SIZE OR DISPLAY SCREEN SIZE - USER DATASET PREFIX - USER'S TERMINAL TYPE - TCAM LINE NUMBER - ADDRESS SPACE ID TERMTYPE - TTY/ASCII/IBM2741/DEC/TIS700/GT/VISTAR/TEK/SOL/DIABLO HYTERM - CODING OF ONE OF THE KEYWORDS LIST ABOVE WILL CAUSE VARIOUS DEFAULT TERMINAL CHARACTERISTICS TO BE ENTERED INTO THE SYSTEM. ANY OF THESE DEFAULTS MAY BE INDIVIDUALLY OVERRIDDEN EITHER BY SETTING THE PARAMETER TO A NEW VALUE EITHER ON THE SAME LINE OR BY ENTERING A NEW SETTERM COMMAND. THE DEFAULTS AS SET BY THESE KEYWORDS ARE LISTED IN THE TABLE BELOW: TYPE LINESIZE LINES CHARDEL LINEDEL TTY 72 NO _ CX/ATTN ASCII 79 22 BS CX/ATTN IBM2741 132 NO BS CX/ATTN DEC 132 NO BS CX/ATTN TIS700 79 NO BS CX/ATTN GT 79 22 BS CX/ATTN VISTAR 79 22 BS CX/ATTN TEK 71 35 _ CX/ATTN SOL 63 NO _ CX/ATTN DIABLO 132 NO BS CX/ATTN HYTERM - ALIAS FOR DIABLO HAZELTINE 79 22 BS CX/ATTN HAZEL - ALIAS FOR HAZELTINE HAZEL80 80 22 BS CX/ATTN H80 - ALIAS FOR HAZEL80 CLEAR - THE CLEAR OPERAND MAY BE USED TO SPECIFY THAT A STRING OF CHARACTERS BE SENT TO THE TERMINAL TO CAUSE THE SCREEN TO BE CLEARED (CRT TERMINALS ONLY). IF SPECIFIED WITH THE TERMINAL TYPE OPERANDS A STRING SPECIFIC TO THE TERMINAL TYPE WILL BE SENT. IF THE TERMINAL TYPE IS NOT SPECIFIED A DEFAULT STRING (X'A11C119A10C') WILL BE SENT. SHOW Page 206 SHOW COMMAND NAME - SHOW FUNCTION - THE SHOW COMMAND IS USED TO DISPLAY THE STATUS OF THE SYSTEM OR THAT OF A PARTICULAR JOB. SYNTAX - SHOWALL/BACKLOG/FETCH/INITIATORS/JOB('JOB-ID')/LINES/ OUTPUT('DEST')/READY('DEST')/USERS PN/FORMS/DEST REQUIRED - NONE DEFAULTS - ALL. 'DEST' IS ASSUMED TO BE LOCAL IF NOT GIVEN. ALIAS- SH OPERANDS - ALL - DISPLAY THE STATUS OF ALL JOBS IN THE SYSTEM THAT HAVE BEEN SUBMITTED UNDER THE SAME ACCOUNT AS THE USER ISSUING THE COMMAND. BACKLOG - DISPLAY THE NUMBER OF JOBS IN EACH SYSTEM QUEUE. FETCH - DISPLAY PN INFORMATION FOR THE FIRST JOB FOUND IN THE FETCH QUEUE BELONGING TO THE USER ISSUING THE COMMAND. INITIATORS - DISPLAY WHICH JOBS ARE ELIGIBLE TO BE RUN SIMULTANEOUSLY. JOB('JOB-ID') - DISPLAY THE STATUS OF A PARTICULAR JOB. 'JOB-ID' - THE JES2 JOB NUMBER OR THE JOB NAME (RECEIPT NUMBER) OF THE DESIRED JOB. LINES - DISPLAY THE USERID OF EACH USER CURRENTLY LOGGED ON TSO. OUTPUT('DEST') - DISPLAY THE NUMBER OF JOBS AWAITING OUTPUT TO THE GIVEN DESTINATION(S) IN EACH CLASS AND FORMS CODE. READY('DEST') - DISPLAY THE OUTPUT FROM THE CURRENT SESSION. SHOW Page 207 SHOW USERS - DISPLAY THE NUMBER OF USERS CURRENTLY LOGGED ON TSO. PN - DISPLAY THE NUMBER OF LINES IN EACH SYSOUT DATA SET OF A JOB IN THE FETCH QUEUE. THIS OPERAND WILL BE IGNORED IF NOT USED IN CONJUNCTION WITH THE JOB OPERAND. FORMS - SAME AS PN, WITH DATA SET FORMS AND COPIES INFORMATION. DEST - SAME AS FORMS, WITH DATA SET DESTINATION AND RECORD LENGTH INFORMATION ADDED. COMMAND NAME - SPACE FUNCTION - THE SPACE COMMAND IS USED TO DISPLAY THE AMOUNT OF DISK SPACE USED BY ON-LINE DATA SETS. DATA SET ATTRIBUTES MAY ALSO BE DISPLAYED. SYNTAX - SPACE LEVEL('INDEX-LEVEL')/LIKE('DSNAME')/ENTRIES('DSLIST') ATTRIBUTES HISTORY VOLUMES('VOLUME-LIST') TOTALS OUTFILE('DDNAME') REQUIRED - NONE DEFAULTS - LEVEL('PREFIX') NOTE - IN ADDITION TO NORMAL TSO SHORT FORMS, 'L' MAY BE USED AS AN ABBREVIATION OF 'LEVEL'. OPERANDS - LEVEL('INDEX-LEVEL') - SPECIFIES THE CATALOG INDEX LEVEL AT WHICH THE SEARCH FOR DATA SETS IS TO BEGIN. LIKE('DSNAME') - SPECIFIES THAT DATA SETS WHOSE NAMES BEGIN WITH THE GIVEN STRING ARE TO BE DISPLAYED. ENTRIES('DSLIST') - SPECIFIES THAT ONLY CERTAIN DATA SETS ARE TO BE DISPLAYED. SPACE Page 208 SPACE ATTRIBUTES - SPECIFIES THAT THE DATA SET ORGANIZATION, RECORD FORMAT, LOGICAL RECORD LENGTH, AND BLOCK SIZE ARE TO BE DISPLAYED. HISTORY - SPECIFIES THAT THE LAST USED AND UPDATED DATES ARE TO BE DISPLAYED. VOLUMES - SPECIFIES THAT THE SERIAL NUMBER ON WHICH EACH DATA SET RESIDES IS TO BE DISPLAYED. ('VOLUME-LIST') - ONLY THE SPECIFIED VOLUMES WILL BE SEARCHED FOR THE DATA SET(S) NAMED BY 'INDEX-LEVEL' OR 'DSLIST'. TOTALS - SPECIFIES THAT ONLY THE TOTAL NUMBER OF TRACKS ALLOCATED AND TRACKS USED ARE TO BE DISPLAYED. OUTFILE('DDNAME') - SPECIFIES THAT THE INFORMATION IS TO BE WRITTEN TO A FILE RATHER THAN TO THE TERMINAL. THE TITLE LINE IS NOT WRITTEN TO THE FILE. COMMAND NAME - SPEAKEZE FUNCTION - THE SPEAKEZE COMMAND INVOLKES THE SPEAKEASY PROCESSOR. SYNTAX - SPEAKEZE LEVEL('LEVNAME') VERSION('VERNUM') LIBRARY('LIBDSN') NEW REQUIRED - NONE DEFAULTS - LEVEL(NU) VERSION(150) - IF TSO REGION LESS THAN 256K VERSION(260) - IF TSO REGION AT LEAST 256K IF LIBARAY KEYWORD IS ENTERED WITHOUT LIBDSN, LIBDSN DEFAULTS TO SPEAKEZ.DATA. OPERANDS - LEVEL('LEVNAME') - LEVEL NAME OF SPEAKEASY PROCESSOR TO BE INVOLKED. 'LEVNAME' - UP TO 8 CHARACTER NAME OF SPEAKEASY LEVEL. AT PRESENT, SPEAKEZE Page 209 SPEAKEZE THE ONLY VALID VALUE FOR THIS OPERAND IS 'NU', WHICH IS THE CURRENT VERSION OF SPEAKEASY. VERSION('VERNUM') - VERSION OF SPEAKEASY PROCESSOR TO BE INVOLKED. 'VERNUM' - UP TO 3 DIGIT VERSION NUMBER OF SPEAKEASY PROCESSOR. CURRENTLY VALID VALUES ARE '150' AND '260'. '150' WILL BE THE DEFAULT IF IN A TSO REGION UNDER 256K, '260' WILL BE THE DEFAULT IF IN A TSO REGION AT LEAST 256K LIBRARY('LIBDSN') - LIBRARY FOR KEEP, KEPT, GET, ETC. OPERATIONS. 'LIBDSN' - NAME OF THE DATASET TO BE ALLOCATED FOR KEEP, KEPT, ETC. OPERATIONS. IF NOT FULLY QUALIFIED, AND IF LAST QUALIFIER IS NOT DATA, A LAST QUALIFIER OF DATA IS ADDED TO THE DATASET NAME. IF THE DATASET DOES NOT EXIST, AND IF THE KEYWORD NEW IS NOT ENTERED, YOU WILL BE PROMPTED FOR PERMISSION TO CREATE THE DATASET. NEW - 'LIBDSN' MIGHT NOT YET EXIST, AND IF IT DOESN'T, IT SHOULD BE CREATED. THIS PARAMETER HAS MEANING ONLY IF LIBRARY KEYWORD IS ENTERED, AND IS IGNORED OTHERWISE. COMMAND NAME - SPITBOL FUNCTION - THE SPITBOL COMMAND IS USED TO INVOKE THE SPITBOL COMPILER. SYNTAX - SPITBOL 'SOURCE-DSNAME' LOAD('OBJECT-DSNAME')/NOLOAD PRINT('PRINT-DSNAME'/*)/NOPRINT PUNCH('PUNCH-DSNAME')/*)/NOPUNCH L('NUMBER') H('NUMBER') N('NUMBER') D('NUMBER') R('NUMBER') T('NUMBER') P('NUMBER') C('NUMBER') REQUIRED - 'SOURCE-DSNAME' DEFAULTS - NOLOAD, PRINT(*), PUNCH(*), L(16K), H(128K), N(58), D(0), R(32K), T(1440), P(100000), C(100000) ALIAS - SNOBOL OPERANDS - 'SOURCE-DSNAME' - THE NAME OF THE DATA SET CONTAINING THE SNOBOL SOURCE PROGRAM. THE DEFAULT LAST QUALIFIER IS .SNOB. SPITBOL Page 210 SPITBOL LOAD - AN OBJECT MODULE IS TO BE PRODUCED. 'OBJECT-DSNAME' - THE NAME OF THE DATA SET INTO WHICH THE OBJECT MODULE IS TO BE WRITTEN. THE DEFAULT LAST QUALIFIER IS .OBJ. NOLOAD - NO OBJECT MODULE IS TO BE PRODUCED. PRINT - COMPILER MESSAGES AND NORMAL OUTPUT ARE TO BE PRODUCED. 'PRINT-DSNAME' - THE NAME OF THE DATA SET INTO WHICH COMPILER MESSAGES AND NORMAL OUTPUT ARE TO BE WRITTEN. THE DEFAULT LAST QUALIFIER IS .LIST. * - COMPILER MESSAGES AND NORMAL OUTPUT ARE TO BE PRINTED AT THE TERMINAL. NOPRINT- COMPILER MESSAGES AND NORMAL OUTPUT ARE NOT TO BE PRODUCED. PUNCH - PUNCHED OUTPUT IS TO BE PRODUCED. 'PUNCH-DSNAME' - THE NAME OF THE DATA SET INTO WHICH PUNCHED OUTPUT IS TO BE WRITTEN. THE DEFAULT LAST QUALIFIER IS .DATA. * - PUNCHED OUTPUT IS TO BE PRINTED AT THE TERMINAL. NOPUNCH- PUNCHED OUTPUT IS NOT TO BE PRODUCED. L - THE LOW LIMIT FOR MEMORY ALLOCATION. H - THE HIGH LIMIT FOR MEMORY ALLOCATION. N - THE NUMBER OF LINES OF PRINTED OUTPUT PER PAGE. D - THE NUMBER OF DUMPS OF SPIBOL SYSTEM ERRORS TO BE GIVEN. R - THE AMOUNT OF MEMORY TO BE RESERVED FOR SYSTEM USE. T - THE MAXIMUM EXECUTION TIME IN SECONDS. P - THE MAXIMUM NUMBER OF PRINTED OUTPUT PAGES. SPITBOL Page 211 SPITBOL C - THE MAXIMUM NUMBER OF PUNCHED CARDS. 'NUMBER' - A 1 TO 10 DIGIT DECIMAL INTEGER, OR A 1 TO 9 DIGIT DECIMAL INTEGER FOLLOWED BY A 'K', INDICATING THAT THE INTEGER IS TO BE MULTIPLIED BY 1024. 'NUMBER' IS USED WITH THE L, H, N, D, R, T, P AND C KEYWORDS. COMMAND NAME - SUGGEST FUNCTION - THE SUGGEST COMMAND WILL PASS A SUGGESTION ABOUT TSO OR ANYTHING ELSE TO THE STAFF OF THE COMPUTER CENTER. SYNTAX - SUGGEST'DATA-SET-NAME' / * ANON REQUIRED - 'DATA-SET-NAME' / * DEFAULTS - NONE ALIASES- NONE OPERANDS - 'DATA-SET-NAME' - THE NAME OF A DATASET WHICH CONTAINS THE TEXT OF YOUR SUGGESTION, TO BE SUBMITTED. * - AN ASTERISK IF YOU WANT TO TYPE YOUR SUGGESTION AT YOUR TERMINAL, WITH PROMPTS FROM THE PROGRAM. ANON - SPECIFY ANON IF YOU DO NOT WANT YOUR NAME SAVED WITH YOUR SUGGESTION. SUMMARY Page 212 SUMMARY COMMAND NAME - SUMMARY FUNCTION- THE SUMMARY COMMAND IS USED TO SUBMIT A BATCH JOB WHICH WILL PRODUCE A PRINTED LISTING OF ACCOUNT INFORMATION AND A BILLING SUMMARY FOR ANY PARTICULAR MONTH OF ANY YEAR THAT THE USER'S ACCOUNT HAS EXISTED. SYNTAX- SUMMARY MONTH('MONTH') YEAR('YEAR') ALL REQUIRED- NONE DEFAULTS- IF NO OPERANDS ARE SPECIFIED, A SUMMARY OF THE MOST RECENT ACCOUNTING PERIOD FOR THE USER'S SUB-ACCOUNT WILL BE PRODUCED. ALIAS - NONE OPERANDS- MONTH - ACCOUNT INFORMATION FOR THIS PARTICULAR MONTH WILL BE SUMMARIZED. 'MONTH'- A ONE OR TWO DIGIT NUMBER CORRESPONDING TO THE MONTH. YEAR - MUST BE USED IN CONJUNCTION WITH THE MONTH OPERAND. IT SPECIFIES THE YEAR. 'YEAR' - A TWO DIGIT NUMBER CORRESPONDING TO THE YEAR REQUIRED. ALL - IF THIS OPERAND IS SPECIFIED, THE USER'S ACCOUNT MUST BE A LEADER. 'ALL' REQUESTS THAT A BILLING SUMMARY IS TO BE PRODUCED FOR ALL SUB-ACCOUNTS OF THE USER'S MASTER ACCOUNT. IF 'ALL' IS NOT SPECIFIED, THEN ACCOUNT INFORMATION FOR THE USER'S SUB-ACCOUNT WILL BE SUMMARIZED. SYSRC Page 213 SYSRC COMMAND NAME - SYSRC FUNCTION - THE SYSRC COMMAND TESTS THE RETURN CODE FROM THE PREVIOUS COMMAND AND TAKES THE REQUESTED ACTION IF THE TEST IS MET. IN THE SYSRC COMMAND THE REMAINDER OF THE PROCEDURE IS NOT DELETED WHEN THE TEST IS MET. THE SYSRC COMMAND MAY ALSO BE USED TO PRINT THE RETURN CODE AT THE TERMINAL. SYNTAX - SYSRC ('OPERATOR' 'N') 'COMMAND' OR SYSRC * REQUIRED - 'OPERATOR', 'N', AND 'COMMAND', OR * DEFAULTS - NONE OPERANDS - 'OPERATOR' - EQ, NE, GT, LT, NG, LE, OR NL 'N' - THE REQUIRED VALUE OF THE RETURN CODE TO MEET THE TEST. 'COMMAND' - ANY VALID TSO COMMAND. * - THE RETURN CODE IS TO BE PRINTED AT THE TERMINAL. COMMAND NAME - TERMINAL FUNCTION - THE TERMINAL COMMAND IS USED TO DEFINE THE PHYSICAL TERMINAL CHARACTERSTICS TO THE TSO SYSTEM. THESE CHARACTERISTICS APPLY TO THE TERMINAL CURRENTLY IN USE AND ARE VALID FOR ONLY ONE SESSION OR UNTIL THE TERMINAL COMMAND IS REISSUED DURING THE SESSION. SYNTAX - TERMINAL LINES('INTEGER')/NOLINES TERMINAL Page 214 TERMINAL SECONDS('INTEGER')/NOSECONDS INPUT('CHARACTER STRING')/NOINPUT LINESIZE('INTEGER')/SCRSIZE('N','M') BREAK/NOBREAK TIMEOUT/NOTIMEOUT CLEAR('CHARACTER STRING')/NOCLEAR TRAN('NAME')/NOTRAN CHAR((X'HEXCHAR',C'CHAR'),...)/NOCHAR REQUIRED - NONE DEFAULTS - NONE ALIAS- TERM NOTE - IF THE TERMINAL COMMAND IS ENTERED WITH NO OPERANDS, THE COMMAND IS IGNORED. NOTE - SOME OF THE TERMINAL COMMAND KEYWORDS ARE NOT SUPPORTED ON ALL TERMINAL TYPES. OPERANDS- LINES('INTEGER') - SPECIFIES THE MAXIMUM NUMBER OF CONTINUOUS OUTPUT WHICH IS TO OCCUR BETWEEN PROMPTS FOR A SIMULATED ATTENTION. 'INTEGER' - MUST BE A VALUE FROM 1-255. NOLINES- SPECIFIES THAT PROMPTING FOR SIMULATED ATTENTIONS TO INTERRUPT OUTPUT WILL BE TERMINATED. SECONDS('INTEGER') - SPECIFIES THE MAXIMUM AMOUNT OF 'LOCKED KEYBOARD' TIME (ALL NUMBERS ARE ROUNDED TO THE NEAREST TEN SECONDS) WHICH IS TO OCCUR BETWEEN PROMPTS FOR SIMULATED ATTENTIONS. 'INTEGER' - MUST BE A VALUE FROM 10 TO 2550. NOSECONDS- SPECIFIES THAT THE USER IS NOT TO BE PROMPTED FOR SIMULATED ATTENTIONS WHEN HIS KEYBOARD WOULD ORDINARILY BE LOCKED AND HIS TERMINAL INACTIVE. INPUT('CHARACTER STRING') - SPECIFIES A CHARACTER STRING WHICH IS TO BE RECOGNIZED DURING INPUT OPERATIONS AS AN ATTENTION. 'CHARACTER STRING' - IS ANY COMBINATION OF 4 OR LESS VALID CHARACTERS. TERMINAL Page 215 TERMINAL NOINPUT- SPECIFIES THAT NO CHARACTER STRING WILL BE USED FOR ATTENTION ON INPUT. LINESIZE('INTEGER') - SPECIFIES THE MAXIMUM NUMBER OF CHARACTERS THAT ARE TO BE PRINTED ON A LINE AT A KEYBOARD TYPE TERMINAL. 'INTEGER' - IS A VALUE FROM 1 TO 255. SCRSIZE('N','M') - SPECIFIES THE DIMENSION OF THE DISPLAY STATION. 'N' - SPECIFIES THE NUMBER OF ROWS ON THE SCREEN. 'M' - SPECIFIES THE LENGTH OF EACH ROW. BREAK - SPECIFIES THAT THE TERMINAL HAS THE REVERSE BREAK FEATURE. NOBREAK- SPECIFIES THAT THE TERMINAL DOES NOT HAVE THE REVERSE BREAK FEATURE. TIMEOUT- SPECIFIES THAT THE TERMINAL DOES NOT HAVE THE TIMEOUT SUPPRESSION FEATURE: WHEN IN TRANSMIT MODE, THE KEYBOARD WILL LOCK IF THE USER DOES NOT STRIKE A KEY WITHIN APPROXIMATELY 9-18 SECONDS. OF THE TERMINALS SUPPORTED FOR FIRST RELEASE, THIS OPERAND IS APPLICABLE ONLY TO 1050 AND NEED BE USED ONLY IF THE INSTALLATION HAS DEFINED THE TERMINAL OR THE LINE ON WHICH IT MAY CALL THE CPU AS HAVING THE TEXT TIMEOUT SUPPRESSION FEATURE. NOTIMEOUT- SPECIFIES THAT THE TERMINAL DOES HAVE THE TIMEOUT SUPPRESSION FEATURE. CLEAR('CHARACTER STRING') - SPECIFIES A CHARACTER STRING TO BE USED TO CLEAR THE SCREEN OF THE DISPLAY STATION. 'CHARACTER STRING' - IS A COMBINATION OF 4 OR LESS VALID CHARACTERS. NOCLEAR- SPECIFIES THAT A CHARACTER STRING WILL NOT BE USED TO ERASE THE SCREEN OF A DISPLAY STATION. TRAN('NAME') - CHARACTER CODE TRANSLATION IS IN EFFECT USING THE TERMINAL Page 216 TERMINAL TABLES CONTAINED IN THE LOAD MODULE SPECIFIED. 'NAME' - THE LOAD MODULE NAME THAT CONTAINS THE TRANSLATE TABLE. NOTRAN - SPECIFIES THAT NO CHARACTER TRANSLATION IS TO TAKE PLACE. CHAR((X'HEXCHAR',C'CHAR'),(C'CHAR',X'HEXCHAR'),...) - SPECIFIES ONE OR MORE PAIRS OF CHARACTERS, IN EITHER HEXADECIMAL OR CHARACTER NOTATION, THAT REPLACE CHARACTERS IN THE TRANSLATE TABLE. '(X'HEXCHAR',C'CHAR'),(C'CHAR',X'HEXCHAR'),...' - THE FIRST CHARACTER OF THE PAIR IS THE CURRENT CHARACTER THAT IS DEFINED. THE SECOND CHARACTER IS THE NEW CHARACTER THAT IS TO REPLACE THE FIRST ONE. EITHER THE FIRST OR THE SECOND CHARACTER MAY BE EXPRESSED IN HEXADECIMAL OR CHARACTER NOTATION. NOCHAR - SPECIFIES THAT ALL CHARACTER TRANSLATIONS PREVIOUSLY SPECIFIED ARE NO LONGER IN EFFECT. TEST Page 217 TEST COMMAND NAME - TEST SUBCOMMANDS - ASSIGN,AT,CALL,COPY,DELETE,DROP,END,EQUATE,FREEMAIN,GETMAIN,GO,LIST, LISTDEB,LISTDCB,LISTMAP,LISTPSW,LISTTCB,LOAD,OFF,QUALIFY,RUN,WHERE FUNCTION - THE TEST COMMAND IS USED TO DEBUG AND VERIFY THE PROPER EXECUTION OF A PROGRAM.THE TEST COMMAND IS MOST READILY USED TO TEST PROGRAMS WRITTEN IN BASIC ASSEMBLER LANGUAGE. A KNOWLEDGE OF THE BASIC ASSEMBLER LANGUAGE IS REQUIRED TO USE THE TEST COMMAND. THE TEST COMMAND ALLOWS YOU TO TEST PROGRAMS IN THE FOLLOWING FORMS- - PROGRAMS CURRENTLY EXECUTING WITHIN THE SYSTEM. - PROGRAMS WHICH HAVE ABNORMALLY TERMINATED (ABEND) AND ARE STILL IN MAIN STORAGE. - PROGRAMS IN OBJECT OR LOAD MODULE FORMS WHICH MUST BE LOADED FROM SEQUENTIAL OR PARTITIONED DATASETS. THE TEST COMMAND ALLOWS YOU TO TEST PROGRAMS BY ENABLING YOU TO- - SUPPLY INITIAL VALUES (TEST DATA) TO THE PROGRAM UNDER TEST. - ESTABLISH BREAKPOINTS WITHIN A PROGRAM WHERE EXECUTION WILL BE INTERRUPTED FOR YOU TO EXAMINE INTERIM RESULTS. - DISPLAY REGISTER AND MAIN STORAGE CONTENTS AT SUCH A BREAKPOINT. - MODIFY REGISTER AND MAIN STORAGE CONTENTS. - DISPLAY THE PROGRAM STATUS WORD (PSW). - LIST THE CONTENTS OF CONTROL BLOCKS, THESE ARE DEB, DCB AND TCB. - STEP THROUGH A SECTION OF THE PROGRAM EXECUTING ONE INSTRUCTION AT A TIME. THE TEST COMMAND ALLOWS YOU TO USE ABSOLUTE AND REGISTER ADDRESSING AS WELL AS ADDRESSING RELATIVE TO THE FIRST BYTE OF THE PROGRAM. SYMBOLIC ADDRESSING CAN BE USED IN THE FOLLOWING INSTANCES- - IF THE PROGRAM WAS BOTH ASSEMBLED AND LINK EDITED USING THE 'TEST' OPTION, THE SYMBOLS IN THE ASSEMBLY CAN BE USED UNDER THE TEST COMMAND.EXCEPTIONS INCLUDE SYMBOLS ON EQU, LTORG, AND ORG STATEMENTS. - IF THE PROGRAM WAS ONLY LINK EDITED WITH THE 'TEST' OPTION, ONLY SYMBOLS IN THE EXTERNAL SYMBOL DICTIONARY CAN BE USED UNDER TEST - ANY SYMBOL DEFINED BY THE USE OF THE EQUATE SUBCOMMAND CAN BE USED. SYNTAX - TEST 'PROGNAME' 'PARAMETERS' LOAD/OBJECT CP/NOCP REQUIRED - NONE DEFAULTS - LOAD,NOCP NOTE - ALL OPERANDS AND KEYWORDS OF THE TEST COMMAND ARE ONLY VALID FOR PROGRAMS WHICH MUST BE LOADED INTO MAIN STORAGE. ACTIVE OR ABENDED PROGRAMS REQUIRE ONLY THE COMMAND 'TEST' WITHOUT OPERANDS OR KEYWORDS. TEST Page 218 TEST OPERANDS - 'PROGNAME' - SPECIFIES THE NAME OF THE DATASET CONTAINING THE PROGRAM TO BE LOADED AND TESTED. 'PARAMETERS' - SPECIFIES A LIST OF PARAMETERS TO BE PASSED TO THE LOADED PROGRAM. THIS LIST CANNOT EXCEED 100 CHARACTERS LOAD - SPECIFIES THAT THE NAMED PROGRAM IS A LOAD MODULE AND IS A MEMBER OF A PARTITIONED DATASET. OBJECT - SPECIFIES THAT THE NAMED PROGRAM IS AN OBJECT MODULE AND IS IN A SEQUENTIAL DATASET OR A PARTITIONED DATASET. CP - SPECIFIES THAT THE NAMED PROGRAM IS A COMMAND PROCESSOR. NOCP - SPECIFIES THAT THE NAMED PROGRAM IS NOT A COMMAND PROCESSOR SUBCOMMAND ASSIGN FUNCTION - THIS FUNCTION IS IMPLICIT, DO NOT ENTER A COMMAND NAME. WITH THIS FUNCTION VALUES CAN BE MODIFIED IN MAIN STORAGE AND REGISTERS WHEN PROCESSING IS HALTED AT A BREAKPOINT OR BEFORE EXECUTION OF PROGRAM BEGINS. THE SYSTEM PERFORMS THIS FUNCTION IN RESPONSE TO THE OPERANDS THAT ARE ENTERED. SYNTAX - 'ADDRESS'=TYPE'VALUE' REQUIRED - ALL OPERANDS ARE REQUIRED. DEFAULTS - NONE NOTE - THIS FUNCTION IS INDICATED BY THE USE OF THE '=' OPERATOR AND A TYPE CODE AND VALUE AFTER AN ADDRESS. OPERANDS - 'ADDRESS' - SPECIFIES THE LOCATION THAT IS TO CONTAIN THE NEW VALUE. THE ADDRESS MAY BE A SYMBOLIC ADDRESS, A RELATIVE ADDRESS, AN ABSOLUTE ADDRESS OR AN INDIRECT ADDRESS. IN ADDITION VALUES IN GENERAL AND FLOATING POINT REGISTERS MAY BE MODIFIED. - GENERAL REGISTERS ARE SPECIFIED AS A DECIMAL INTEGER TEST Page 219 TEST WITHIN THE RANGE OF 0 THROUGH 15 TO INDICATE THE REGISTER NUMBER FOLLOWED BY AN R. IE. 1R OR 14R - FLOATING POINT REGISTERS ARE SPECIFIED BY A DECIMAL INTEGER FOLLOWED BY AN E FOR REGISTER WITH SINGLE PRECISION OR A D FOR REGISTER WITH DOUBLE PRECISION. THE DECIMAL INTEGER MUST BE 0,2,4, OR 6. IE. 0D OR 2E - FOR A MORE DETAILED DISCUSSION OF THE OTHER TYPES OF ADDRESSES ENTER - HELP GO OPERANDS TYPE''VALUE'' - SPECIFIES THE TYPE AND VALUE OF THE DATA TO BE PLACED IN THE SPECIFIED LOCATION. INCLUDE THE DATA, ENCLOSED WITHIN APOSTROPHES, FOLLOWING THE TYPE CODE. INDICATE THE TYPE OF DATA BY ONE OF THE FOLLOWING CODES- CODE TYPE OF DATA MAX LENGTH(INPUT CHARACTERS) ---- ------------ ------------------------------ C CHARACTER SEE NOTE X HEXADECIMAL 64 B BINARY 64 H FIXED POINT BINARY (HALFWORD) 6 F FIXED POINT BINARY (FULLWORD) 11 E FLOATING POINT (SINGLE) 13 D FLOATING POINT (DOUBLE) 22 P PACKED DECIMAL 32 Z ZONED DECIMAL 17 A ADDRESS CONSTANT 10 S ADDRESS (BASE+DISPLACEMENT) 8 Y ADDRESS CONSTANT (HALFWORD) 5 NOTE - THE MAXIMUM POSSIBLE LENGTH FOR A CHARACTER VALUE IN THIS FUNCTION WILL BE THE MAXIMUM LEGAL LINE LENGTH MINUS FIVE. CONTINUATION OF LINES IS PERMITTED. SUBCOMMAND AT FUNCTION - THE AT COMMAND ESTABLISHES A BREAKPOINT AT THE ADDRESS/ADDRESSES SPECIFIED IN THE PROGRAM BEING TESTED. SYNTAX - AT 'ADDR'/'ADDR1' COLON 'ADDR2'/'ADDR-LIST' ('SUBCOMMAND CHAIN') COUNT('INTEGER') NODEFER/DEFER NOTIFY/NONOTIFY REQUIRED - 'ADDR' OR 'ADDR1' COLON 'ADDR2' OR 'ADDR-LIST' DEFAULTS - NODEFER AND NOTIFY OPERANDS - 'ADDR' - A HALFWORD BOUNDARY ADDRESS AT WHICH A BREAKPOINT IS TO BE TEST Page 220 TEST ESTABLISHED. 'ADDR1'- THE FIRST ADDRESS OF A RANGE IN WHICH BREAKPOINTS ARE TO BE ESTABLISHED. THIS ADDRESS MUST BE ON A HALFWORD BOUNDARY. 'ADDR2'- THE FINAL ADDRESS OF A RANGE IN WHICH BREAKPOINTS ARE TO BE ESTABLISHED. 'ADDR-LIST' - ONE OR MORE HALFWORD BOUNDARY ADDRESSES OR ADDRESS RANGES ENCLOSED IN PARENTHESIS AND SEPARATED BY ONE OF THE STANDARD DELIMITERS AT WHICH A BREAKPOINT IS TO BE ESTABLISHED. - FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS 'SUBCOMMAND CHAIN' - ONE OR MORE TEST SUBCOMMANDS SEPARATED BY SEMI-COLONS TO BE EXECUTED WHEN THE PROGRAM IS INTERRUPTED AT THE INDI- CATED LOCATION. THE CHAIN MAY NOT EXCEED 255 BYTES. COUNT('INTEGER') - THE PROGRAM IS TO BE HALTED AND THE TEST MODE ENTERED EVERY 'INTEGER' TIME THE BREAKPOINT IS ENCOUNTERED. THE COUNT MUST BE BETWEEN 0 AND 65535. NODEFER- THE BREAKPOINT IS TO BE ESTABLISHED IN A PROGRAM IN MAIN STORAGE. DEFER - THE BREAKPOINT REQUEST IS TO BE SAVED UNTIL THE PROGRAM IS SUBSEQUENTLY BROUGHT INTO STORAGE VIA A LINK, LOAD, ATTACH, OR XCTL. WHEN DEFER IS SPECIFIED THE ADDRESS MUST BE FULLY QUALIFIED. (I.E. LOADNAME.CSECTNAME.XXX) NOTIFY - A MESSAGE IS TO BE PRINTED TO INFORM THE PROGRAMMER EACH TIME THE BREAKPOINT IS ENCOUNTERED. NONOTIFY - NO MESSAGE IS TO BE PRINTED TO INFORM THE PROGRAMMER THAT THE BREAKPOINT HAS BEEN ENCOUNTERED. SUBCOMMAND CALL FUNCTION - THE CALL COMMAND RESULTS IN A CHANGE FROM COMMAND MODE TO PROBLEM PROGRAM MODE. CALL INITIALIZES REGISTERS 1, 14, AND 15 OF THE PROBLEM PROGRAM AT THE TIME EXECUTION BEGINS AND IT PROVIDES FOR PASSING OF A PARAMETER LIST TO THE PROBLEM PROGRAM. TEST Page 221 TEST SYNTAX - CALL 'ADDR' PARM('ADDR'/'ADDR-LIST') VL RETURN('ADDR') REQUIRED - 'ADDR' DEFAULTS -(CALL 'ADDR') WILL RESULT IN INITIALIZING REGISTER 15 TO CONTAIN THE ADDRESS SPECIFIED FOR ENTRY. REGISTER 14 WILL CONTAIN A RETURN ADDRESS WHICH WILL CAUSE A CHANGE TO COMMAND MODE. REGISTER 1 IS SET TO POINT TO A NULL PARAMETER LIST. OPERANDS - 'ADDR' - THE ADDRESS WHERE EXECUTION SHOULD BEGIN IN THE PROBLEM PROGRAM. PARM('ADDR') - A ONE WORD PARAMETER LIST IN THE FORM OF AN ADDRESS TO BE PASSED TO THE PROBLEM PROGRAM. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS PARM('ADDR-LIST') - A LIST OF PARAMETERS IN THE FORM OF ADDRESSES SEPARATED BY ONE OF THE STANDARD DELIMITERS TO BE PASSED TO THE PROBLEM PROGRAM. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS VL - CAUSES THE HIGH-ORDER BIT OF THE LAST PARAMETER TO BE SET TO 1 RETURN('ADDR') - CAUSES REGISTER 14 TO BE SET TO THE ADDRESS SPECIFIED. AFTER EXECUTION CONTROL WILL BE RETURNED TO THIS ADDRESS. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS SUBCOMMAND COPY (MAY BE ABBREVIATED C) FUNCTION - THE COPY SUBCOMMAND COPIES FROM STORAGE TO STORAGE, STORAGE TO REGISTERS,REGISTERS TO STORAGE AND ALSO FROM REGISTERS TO REGISTERS. IT ALSO OBTAINS ADDRESSES AND PLACES THESE IN STORAGE OR A REGISTER. SYNTAX - COPY 'ADDR1' 'ADDR2' LENGTH('INTEGER') POINTER/NOPOINT TEST Page 222 TEST REQUIRED - 'ADDR1' 'ADDR2' DEFAULTS - 'INTEGER' HAS A MAXIMUM DEFAULT VALUE OF DECIMAL 64 IF A GENERAL REGISTER IS SPECIFIED AS 'ADDR1' OR 'ADDR2' AND NOPOINT IS USED. IF POINTER IS SPECIFIED A MAXIMUM LENGTH OF 4 WILL BE THE DEFAULT. 'NOPOINT' IS ALSO A DEFAULT. OPERANDS - 'ADDR1'- THIS IS THE ADDRESS OR THE REGISTER IN WHICH THE DATA TO BE COPIED IS CONTAINED. 'ADDR2'- THIS IS THE ADDRESS OR REGISTER WHICH WILL RECEIVE THE COPY. LENGTH('INTEGER') - THIS SPECIFIES, IN DECIMAL, THE LENGTH OF THE FIELD TO BE COPIED. POINTER- THIS KEYWORD CHANGES THE MEANING OF 'ADDR1'. ALSO, IN THIS CASE 'ADDR1' CAN NOT BE A GENERAL REGISTER. 'ADDR1' WILL BE TREATED AS DATA AND PUT IN REGISTER OR ADDRESS SPECIFIED BY 'ADDR2'. SUBCOMMAND DELETE (MAY BE ABBREVIATED DEL) FUNCTION - THE DELETE COMMAND CAUSES THE SPECIFIED PROGRAM AND ITS SYMBOL TABLE TO BE DELETED FROM MAIN STORAGE. SYNTAX - DELETE 'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE OPERANDS - 'DSNAME' - THE NAME OF THE PROGRAM TO BE DELETED SUBCOMMAND DROP FUNCTION - THE DROP COMMAND WILL DELETE THE NAMED SYMBOL FROM THE SYMBOL TABLE CREATED BY THE EQUATE COMMAND. SYNTAX - DROP 'SYMBOL'/'SYMBOL-LIST' REQUIRED - NONE DEFAULTS - (DROP) WILL CAUSE ALL THE ENTRIES IN THE SYMBOL TABLE TEST Page 223 TEST CREATED BY THE EQUATE COMMAND TO BE DELETED. NOTE - IF THE PROGRAM BEING TESTED WAS ASSEMBLED WITH THE TEST OPTION AND THE EQUATE COMMAND WAS USED TO OVERRIDE THE LOCATION OF THE SYMBOL WITHIN THE PROGRAM AND THE DROP COMMAND IS THEN USED TO DELETE THAT SYMBOL FROM THE SYMBOL TABLE, THEN THE SYMBOL WILL REFLECT THE ORIGINAL LOCATION WITHIN THE PROGRAM. OPERANDS - 'SYMBOL' - THE SYMBOL TO BE DELETED FROM THE SYMBOL TABLE. 'SYMBOL-LIST' - A LIST OF SYMBOLS ENCLOSED IN PARENTHESIS AND SEPARATED BY ONE OF THE STANDARD DELIMITERS TO BE DELETED FROM THE SYMBOL TABLE. SUBCOMMAND END FUNCTION - THE END COMMAND TERMINATES THE TEST SESSION. SYNTAX - END REQUIRED - NONE DEFAULTS - NONE OPERANDS - NONE SUBCOMMAND EQUATE (MAY BE ABBREVIATED EQ) FUNCTION - THE EQUATE COMMAND WILL ADD THE NAMED SYMBOL TO THE SYMBOL TABLE FOR THE MODULE BEING TESTED. SYNTAX - EQUATE 'SYMBOL' 'ADDRESS' 'TYPE' LENGTH('INTEGER') MULTIPLE('INTEGER') REQUIRED - 'SYMBOL', 'ADDRESS' DEFAULTS - TYPE, LENGTH('INTEGER'), MULTIPLE('INTEGER') (EQUATE 'SYMBOL' 'ADDRESS') WILL CAUSE THE SYMBOL SPECIFIED TO BE ADDED TO THE SYMBOL TABLE WITH TYPE DEFAULTING TO HEX, LENGTH DEFAULTING TO 4, AND MULTIPLICITY DEFAULTING TO 1. TEST Page 224 TEST ALIAS- EQ NOTES- WHEN AN ENTRY ALREADY EXISTS FOR A 'SYMBOL' THE EXISTING ENTRY IS OVERRIDDEN WITH THE NEW CHANGES. IE. 'ADDR' WHEN THE TYPE ATTRIBUTE IS CHANGED FOR AN EXISTING ENTRY THE MULTIPLICITY AND LENGTH ATTRIBUTES WILL BE ALSO CHANGED TO REFLECT THE NEW TYPE. WHEN THE ADDRESS IS CHANGED FOR AN EXISTING ENTRY THE TYPE AND ATTRIBUTES WILL DEFAULT TO HEX, 4, 1 AS DISCUSSED UNDER 'DEFAULTS' UNLESS OTHERWISE SPECIFIED. OPERANDS - 'SYMBOL' - THE SYMBOL TO BE ADDED TO THE SYMBOL TABLE. THE SYMBOL CAN BE FROM ONE TO EIGHT CHARACTERS LONG, THE FIRST OF WHICH MUST BE AN ALPHABETIC OR NATIONAL CHARACTER AND THE REST ALPHANUMERIC. 'ADDRESS' - ADDRESS TO WHICH 'SYMBOL' IS TO BE ASSOCIATED. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS 'TYPE' - THE TYPE ATTRIBUTE TO BE ASSOCIATED WITH 'SYMBOL'. VALID TYPE ATTRIBUTES ARE- C - CHARACTER X - HEXADECIMAL B - BINARY I - INSTRUCTION F - FIXED POINT, FULLWORD H - FIXED POINT, HALFWORD E - FLOATING POINT, FULLWORD A - A OR Q ADDR CONSTANT D - FLOATING POINT, DOUBLEWORD Y - Y ADDRESS CONSTANT S - S ADDRESS CONSTANT P - PACKED DECIMAL Z - ZONED DECIMAL LENGTH('INTEGER') - THE LENGTH ATTRIBUTE TO BE ASSOCIATED WITH 'SYMBOL'. THE VALID RANGE OF LENGTHS FOR DIFFERENT TYPES ARE TYPE MINIMUM MAXIMUM TYPE MINIMUM MAXIMUM C 1 256 X 1 256 B 1 256 I 1 256 F 1 8 H 1 8 E 1 8 D 1 8 A 1 4 Y 1 2 S 2 2 P 1 16 Z 1 16 MULTIPLE('INTEGER') - THE MULTIPLICITY ATTRIBUTE TO BE ASSOCIATED WITH 'SYMBOL'. THE INTEGER MUST BE IN A RANGE FROM 1 TO 256. SUBCOMMAND FREEMAIN (MAY BE ABBREVIATED FREE) TEST Page 225 TEST FUNCTION - THE FREEMAIN COMMAND WILL FREE CORE PREVIOUSLY ACCESSED BY A GETMAIN COMMAND. SYNTAX FREEMAIN 'INTEGER1' 'ADDR' SP('INTEGER2') REQUIRED - 'INTEGER1','ADDR' DEFAULTS - IF SUBPOOL (SP) IS NOT SPECIFIED, SUBPOOL ZERO IS ASSUMED. ALIAS- FREE OPERANDS - 'INTEGER1' - THE NUMBER OF BYTES OF STORAGE TO BE FREED. 'ADDR' - THE ADDRESS OF THE FIRST BYTE TO BE FREED. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS SP('INTEGER2') - 'INTEGER' IS THE NUMBER OF THE SUBPOOL IN WHICH CORE IS TO BE FREED. SUBCOMMAND GETMAIN (MAY BE ABBREVIATED GET) FUNCTION - THE GETMAIN COMMAND RESULTS IN AN ATTEMPT TO ACQUIRE THE SPECIFIED NUMBER OF BYTES OF STORAGE. SYNTAX - GETMAIN 'INTEGER1' SP('INTEGER2') EQUATE('SYMBOL') REQUIRED - 'INTEGER1' DEFAULTS - IF SUBPOOL (SP) IS NOT SPECIFIED, SUBPOOL ZERO IS ASSUMED. ALIAS- GET OPERANDS - 'INTEGER1' - THE NUMBER OF BYTES OF STORAGE DESIRED SP('INTEGER2') - 'INTEGER2' IS THE NUMBER OF THE SUBPOOL IN WHICH STORAGE IS TO BE OBTAINED. TEST Page 226 TEST EQUATE('SYMBOL') - NAME OF SYMBOL TO BE EQUATED TO GETMAIN AREA ADDRESS ALL ATTRIBUTES FOR THIS SYMBOL WILL BE DEFAULTED. SUBCOMMAND GO FUNCTION - THE GO COMMAND RESULTS IN A CHANGE FROM COMMAND MODE TO PROBLEM PROGRAM MODE. EXECUTION OF THE PROBLEM PROGRAM PROCEEDS FROM THE POINT OF LAST INTERRUPTION, OR FROM THE INITIAL ENTRY POINT OF THE PROGRAM IF IT WAS LOADED BY TEST AND THIS IS THE FIRST EXECUTION, OR FROM THE SPECIFIED ADDRESS. SYNTAX - GO 'ADDR' REQUIRED - NONE DEFAULTS - (GO) WILL CAUSE EXECUTION IN THE PROBLEM PROGRAM TO PROCEED FROM THE POINT OF LAST INTERRUPTION, OR FROM THE INITIAL ENTRY POINT OF THE PROGRAM IF IT WAS LOADED BY TEST AND THIS IS THE FIRST EXECUTION. OPERANDS - 'ADDRESS' - FOR GO THIS ADDRESS SPECIFIES WHERE EXECUTION SHOULD BEGIN IN THE PROBLEM PROGRAM. THE ADDRESS MAY BE A SYMBOLIC ADDRESS, A RELATIVE ADDRESS, AN ABSOLUTE ADDRESS OR AN INDIRECT ADDRESS. - A SYMBOLIC ADDRESS CONSISTS OF ONE THROUGH EIGHT ALPHAMERIC CHARACTERS, THE FIRST OF WHICH IS AN ALPHABETIC OR NATIONAL CHARACTER. THE ADDRESS MUST CORRESPOND TO A SYMBOL IN THE PROGRAM THAT IS BEING TESTED. IE. A123DCV OR AAA - A RELATIVE ADDRESS IS A HEXADECIMAL NUMBER PRECEDED BY A PLUS SIGN (+). IE. +4 - AN ABSOLUTE ADDRESS IS A HEXADECIMAL NUMBER FOLLOWED BY A PERIOD (.). IE. 7EDF8. - AN INDIRECT ADDRESS IS AN ADDRESS OF A LOCATION OR GENERAL REGISTER THAT CONTAINS ANOTHER ADDRESS. AN INDIRECT ADDRESS MUST BE FOLLOWED BY A PERCENT SIGN (%). FLOATING POINT REGISTERS MAY NOT BE USED FOR INDIRECT ADDRESSING. IE. 7EDF8.% OR 5R% - QUALIFIED ADDRESSES-YOU CAN QUALIFY SYMBOLIC AND RELATIVE ADDRESSES TO INDICATE THAT THEY APPLY TO A PARTICULAR CONTROL SECTION (CSECT). TO DO THIS, YOU PRECEDE THE ADDRESS BY EITHER THE NAME OF THE LOAD MODULE AND THE NAME OF AN ENTRY POINT OR JUST THE NAME OF AN TEST Page 227 TEST ENTRY POINT. THE QUALIFIED ADDRESS MUST BE IN THE FORM- .ENTRYNAME.ADDRESS OR LOADNAME.ENTRYNAME.ADDRESS SUBCOMMAND LIST (MAY BE ABBREVIATED L) FUNCTION - THE LIST COMMAND ALLOWS YOU TO HAVE THE CONTENTS OF A SPECIFIED AREA OF MAIN STORAGE, OR THE CONTENTS OF REGISTERS, DISPLAYED AT YOUR TERMINAL OR PLACED INTO A DATASET. SYNTAX - LIST 'ADDRESS'/'ADDRESS COLON ADDRESS'/'ADDRESS LIST' 'TYPE' LENGTH('INTEGER') MULTIPLE('INTEGER') PRINT('DATASET NAME') REQUIRED - 'ADDRESS'/'ADDRESS COLON ADDRESS'/'ADDRESS LIST' DEFAULTS - X FOR TYPE, MULTIPLE(1), TERMINAL DISPLAY AND THE FOLLOWING DEFAULTS APPLY FOR LENGTH('INTEGER') ACCORDING TO DATA TYPE. DATA TYPE DEFAULT LENGTH IN BYTES C,B,P,Z 1 H,S,Y 2 F,E,A,X 4 D 8 I VARIABLE ALIAS - L NOTE - ALL ADDRESSES REFERRED TO IN THE OPERAND DEFINITIONS MAY REFER TO MAIN STORAGE LOCATIONS, GENERAL REGISTERS, OR FLOATING POINT REGISTERS. - GENERAL REGISTERS ARE SPECIFIED AS A DECIMAL INTEGER WITHIN THE RANGE OF 0 THROUGH 15 TO INDICATE THE REGISTER NUMBER FOLLOWED BY AN R. IE. 1R OR 14R - FLOATING POINT REGISTERS ARE SPECIFIED BY A DECIMAL INTEGER FOLLOWED BY AN E FOR REGISTER WITH SINGLE PRECISION OR A D FOR REGISTER WITH DOUBLE PRECISION. THE DECIMAL INTEGER MUST BE 0,2,4, OR 6. IE. 0D OR 2E OPERANDS - 'ADDRESS' - SPECIFIES THE LOCATION OF DATA THAT IS TO BE DISPLAYED AT YOUR TERMINAL OR PLACED INTO A DATASET. 'ADDRESS COLON ADDRESS' - SPECIFIES THAT THE DATA LOCATED BETWEEN THE SPECIFIED ADDRESSES IS TO BE DISPLAYED TO THE TERMINAL OR PLACED INTO A DATASET. 'ADDRESS LIST' - SPECIFIES SEVERAL ADDRESSES OF DATA THAT ARE TO BE TEST Page 228 TEST DISPLAYED TO THE TERMINAL OR PLACED INTO A DATASET. THE DATA AT EACH LOCATION WILL BE RETRIEVED. THE LIST OF ADDRESSES MUST BE ENCLOSED WITHIN PARENTHESIS AND THE ADDRESSES MUST BE SEPARATED BY STANDARD DELIMITERS. - FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS AND HELP LIST SYNTAX 'TYPE' - SPECIFIY ONE OR MORE OF THE FOLLOWING DATA ATTRIBUTE CODES TO INDICATE THE TYPE OF THE DATA. EACH ATTRIBUTE IS ENTERED AS IF IT WERE A KEYWORD. CODE DATA TYPE CODE DATA TYPE C CHARACTER P PACKED DECIMAL X HEXADECIMAL Z ZONED DECIMAL B BINARY I INSTRUCTION H FIXED POINT (HALF A ADDRESS CONSTANT F FIXED POINT (FULL) S ADDRESS (BASE+ E FLOATING POINT (SINGLE) DISPLACEMENT) D FLOATING POINT (DOUBLE) Y TWO BYTE ADDRESS CONSTANT LENGTH('INTEGER') - SPECIFIES THE LENGTH OF THE DATA. THE MAXIMUM VALUE OF THE INTEGER IS 256. SEE SYNTAX FOR DEFAULT VALUES. MULTIPLE('INTEGER') - SPECIFIES THE MULTIPLICITY ATTRIBUTE OF THE SPECIFIED DATA. THE INTEGER MUST BE IN THE RANGE OF 1 TO 256. PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF THIS OPERAND IS OMITTED, THE DATA WILL GO TO THE TERMINAL. IF THE DATASET IS OLD THE ATTRIBUTES ARE EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LISTDEB TEST Page 229 TEST FUNCTION - THE LISTDEB COMMAND WILL CAUSE THE PRINT OUT OF THE DATA EXTENT BLOCK AT THE SPECIFIED ADDRESS. THE 32 BYTE BASIC SECTION AND EACH 16 BYTE DIRECT ACCESS SECTION CAN BE PRINTED. THE SPECIFIED ADDRESS MUST BE THE BEGINNING OF A VALID DATA EXTENT BLOCK. SYNTAX - LISTDEB 'ADDRESS' FIELD('FIELD'/'FIELD-LIST') PRINT('DATASET NAME') REQUIRED - 'ADDRESS' DEFAULTS - (LISTDEB 'ADDRESS') WILL CAUSE THE BASIC SECTION AND EACH DIRECT ACCESS SECTION TO BE PRINTED OUT TO THE TERMINAL NOTE - IF FIELD('FIELD-LIST'/'FIELD') IS SPECIFIED THE SECTION HEADERS IE. BASIC SECTION, ARE NOT OUTPUTTED. OPERANDS - 'ADDRESS' - ADDRESS OF A VALID DATA EXTENT BLOCK. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS FIELD('FIELD') - A VALID DEB FIELD NAME FIELD('FIELD-LIST') - A LIST OF VALID DEB FIELD NAMES IN ANY ORDER ENCLOSED IN PARENTHESIS AND SEPARATED BY ONE OF THE STANDARD DELIMITERS. THE FIELD NAME IS THE NAME GIVEN IN THE LATEST LEVEL OF THE SYSTEM CONTROL BLOCKS SRL. FOR EXAMPLE - FIELD(DEBUCBAD,DEBNMENT) WILL PRINT OUT THE FIELDS IN THE SPECIFIED DEB CONTAINING THE ADDRESS OF THE UCB AND THE NUMBER OF EXTENTS. PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF THIS OPERAND IS OMITTED, THE DATA WILL GO TO YOUR TERMINAL. IF THE DATASET IS OLD THE ATTRIBUTES ARE EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST Page 230 TEST TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LISTDCB FUNCTION - THE LISTDCB COMMAND WILL CAUSE THE PRINT OUT OF THE DATA CONTROL BLOCK AT THE SPECIFIED ADDRESS SYNTAX - LISTDCB 'ADDRESS' FIELD('FIELD'/'FIELD-LIST') PRINT('DATASET NAME') REQUIRED - 'ADDRESS' DEFAULTS - (LISTDCB 'ADDRESS') WILL CAUSE THE DEVICE INTERFACE SEGMENT FOR DIRECT-ACCESS STORAGE DEVICES, THE COMMON INTERFACE SEGMENT, THE FOUNDATION EXTENSION SEGMENT, AND THE FOUNDATION EXTENSION SECTIONS TO BE OUTPUTTED FROM THE SPECIFIED ADDRESS TO THE TERMINAL. NOTE - IF FIELD('FIELD-LIST'/'FIELD') IS SPECIFIED THE SECTION HEADERS IE. COMMON INTERFACE, ARE NOT OUTPUTTED. OPERANDS - 'ADDRESS' - ADDRESS OF A DATA CONTROL BLOCK. MUST BEGIN ON A FULLWORD BOUNDARY. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS FIELD('FIELD') - A VALID DCB FIELD NAME FIELD('FIELD-LIST') - A LIST OF VALID DCB FIELD NAMES IN ANY ORDER ENCLOSED IN PARENTHESIS AND SEPARATED BY ONE OF THE STANDARD DELIMITERS. THE FIELD NAME IS THE NAME GIVEN IN THE LATEST LEVEL OF THE SYSTEM CONTROL BLOCKS SRL. PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF THIS OPERAND IS OMITTED, THE DATA WILL GO TO THE TERMINAL. IF THE DATASET IS OLD THE ATTRIBUTES ARE TEST Page 231 TEST EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LISTMAP FUNCTION - THE LISTMAP COMMAND WILL CAUSE A PRINT OUT OF THE STORAGE MAP. SYNTAX - LISTMAP PRINT('DATASET NAME') REQUIRED - NONE DEFAULTS - (LISTMAP) WILL CAUSE THE STORAGE MAP TO BE PRINTED AT THE TERMINAL OPERANDS - PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF YOU OMIT THIS OPERAND, THE DATA WILL GO TO THE TERMINAL. IF THE DATASET IS OLD THE ATTRIBUTES ARE EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LISTPSW TEST Page 232 TEST FUNCTION - THE LISTPSW COMMAND WILL CAUSE THE PRINT OUT OF A PROGRAM STATUS WORD. SYNTAX - LISTPSW ADDR('ADDRESS') PRINT('DATASET NAME') REQUIRED - NONE DEFAULST - (LISTPSW) WILL CAUSE THE CURRENT PROGRAM STATUS WORD AS OF THE LAST INTERRUPT TO BE PRINTED AT THE TERMINAL OPERANDS - ADDR('ADDRESS') - ADDRESS OF A VALID PROGRAM STATUS WORD. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF THIS OPERAND IS OMITTED, THE DATA WILL GO TO THE TERMINAL. IF THE DATASET IS OLD THE ATTRIBUTES ARE EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LISTTCB FUNCTION - THE LISTTCB COMMAND WILL CAUSE THE PRINT OUT OF A TASK CONTROL BLOCK. SYNTAX - LISTTCB ADDR('ADDRESS') FIELD('FIELD'/'FIELD-LIST') PRINT('DATASET NAME') REQUIRED - NONE DEFAULTS - IF ADDR('ADDRESS') IS NOT SPECIFIED, THE PROBLEM PROGRAM TEST Page 233 TEST PROGRAM TCB WILL BE USED. IF FIELD('FIELD/'FIELDLIST') IS NOT SPECIFIED, ALL FIELDS OF THE TCB WILL BE LISTED. IF PRINT('DATASET NAME') IS NOT SPECIFIED, THE DATA WILL BE PRINTED AT THE TERMINAL. OPERANDS - ADDR('ADDRESS') - 'ADDRESS' IS THE ADDRESS OF A VALID TASK CONTROL BLOCK. FOR A MORE DETAILED DISCUSSION ON THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS FIELD('FIELD') - A VALID TCB FIELD NAME. FIELD('FIELD-LIST') - A LIST OF VALID TCB FIELD NAMES IN ANY ORDER ENCLOSED IN PARENTHESIS AND SEPARATED BY ONE OF THE STANDARD DELIMITERS. PRINT('DATASET NAME') - SPECIFIES THE NAME OF A DATASET TO WHICH THE DATA IS DIRECTED. IF THIS OPERAND IS OMITTED, THE DATA WILL GO TO THE TERMINAL. IF THE DATASET IS OLD, THE ATTRIBUTES ARE EXAMINED. IF THE RECORD FORMAT IS NOT A VARIABLE TYPE, THE ATTRIBUTES OF THE DATASET ARE CHANGED TO VB, LRECL=125, BLKSIZE=1629. IF THE DATASET IS A VARIABLE TYPE, THE LRECL MUST BE AT LEAST 125 AND THE BLKSIZE 129. IF NOT THEY WILL BE CHANGED TO THOSE VARIABLES. IF THE DATASET DOES NOT EXIST IT IS ALLOCATED WITH VB, LRECL=125, BLKSIZE=1629 WITH A DISPOSITION OF NEW,CATALOG,CATALOG. THE SPECIFIED DATASET IS KEPT OPEN UNTIL THE TEST SESSION IS ENDED BY A RUN OR END COMMAND OR A LIST COMMAND IS ENTERED SPECIFYING A DIFFERENT PRINT DATASET. IN THIS CASE, THE PREVIOUS DATASET IS CLOSED AND THE CURRENT ONE IS OPENED. SUBCOMMAND LOAD FUNCTION - THE LOAD COMMAND CAUSES THE SPECIFIED PROGRAM TO BE LOADED INTO MAIN STORAGE. TEST Page 234 TEST SYNTAX - LOAD 'DSNAME('MEMBER')'/'PASSWORD' REQUIRED - 'DSNAME('MEMBER')' DEFAULTS - NONE NOTE - A SLASH MUST BE USED BEFORE THE PASSWORD. OPERANDS - 'DSNAME('MEMBER')' - 'DSNAME' IS THE DATASET WHICH CONTAINS 'MEMBER', THE NAME OF THE PROGRAM TO BE LOADED. 'PASSWORD' - IS THE PASSWORD FOR A PASSWORD PROTECTED DATASET. SUBCOMMAND OFF FUNCTION - THE OFF COMMAND WILL REMOVE A BREAKPOINT(S) ESTABLISTHED BY THE AT COMMAND. SYNTAX - OFF 'ADDR1'/'ADDR-LIST'/'ADDR1' COLON 'ADDR2' REQUIRED - NONE DEFAULTS - NONE OPERANDS - 'ADDR1'- AN ADDRESS AT WHICH A BREAKPOINT IS TO BE REMOVED. 'ADDR-LIST' - THE LIST OF ADDRESSES AT WHICH BREAKPOINTS ARE TO BE REMOVED. 'ADDR1' COLON 'ADDR2' - 'ADDR1' IS THE STARTING ADDRESS OF A RANGE IN WHICH ALL BREAKPOINTS WILL BE REMOVED. - 'ADDR2' IS THE FINAL ADDRESS OF A RANGE IN WHICH BREAKPOINTS WILL BE REMOVED. - FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS SUBCOMMAND QUALIFY (MAY BE ABBREVIATED Q) FUNCTION - THE QUALIFY COMMAND ENABLES THE USER TO ACCESS MAIN STORAGE LOCATIONS WITHIN A PROGRAM BY MEANS OF RELATIVE, SYMBOLIC, OR ABSOLUTE ADDRESSES. TEST Page 235 TEST SYNTAX - QUALIFY 'ADDR'/'LOADNAME'/'LOADNAME.ENTRYNAME'/'.ENTRYNAME'/ '.ENTRYNAME.SYMBOL'/'LOADNAME.ENTRYNAME.SYMBOL'/ 'SYMBOL' TCB('ADDR') REQUIRED - 'ADDR' OR 'LOADNAME' OR '.ENTRYNAME' OR 'SYMBOL' DEFAULTS - NONE OPERANDS - 'ADDR' - THE ADDRESS TO BE USED AS A BASE ADDRESS IN TESTING. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS 'LOADNAME' - THE LOAD MODULE NAME FOR WHICH QUALIFICATION IS TO BE ESTABLISHED. 'LOADNAME.ENTRYNAME' - THE LOAD MODULE NAME AND ENTRY POINT NAME FOR WHICH IMPLICIT QUALIFICATION IS TO BE ESTABLISHED. '.ENTRYNAME' - THE CSECTNAME OR ENTRYNAME CONTAINED IN THE CURRENTLY QUALIFIED LOAD MODULE FOR WHICH QUALIFICATION IS TO BE ESTABLISHED. '.ENTRYNAME.SYMBOL' - THE SYMBOLIC LABEL NAME CONTAINED IN THE SPECIFIED CSECT (WHICH IS IN TURN CONTAINED IN THE CURRENTLY QUALIFIED LOAD MODULE), FOR WHICH QUALIFICATION IS TO BE ESTABLISHED. 'LOADNAME.ENTRYNAME.SYMBOL' - THE SYMBOLIC LABEL NAME CONTAINED IN THE SPECIFIED CSECT OF THE SPECIFIED LOAD MODULE FOR WHICH QUALIFICATION IS TO BE ESTABLISHED. 'SYMBOL' - EITHER A SYMBOLIC NAME WITHIN THE CURRENTLY QUALIFIED CSECT, OR A RELATIVE DISPLACEMENT FROM THE BEGINNING OF THE CURRENTLY QUALIFIED CSECT. TCB('ADDR') - EITHER THE ABSOLUTE ADDRESS, OR AN INDIRECT REGISTER ADDRESS OF THE TASK CONTROL BLOCK TO BE USED IN THE SEARCH FOR THE SPECIFIED LOAD MODULE. SUBCOMMAND RUN (MAY BE ABBREVIATED R) FUNCTION - THE RUN COMMAND RESULTS IN A CHANGE FROM COMMAND MODE TO PROBLEM PROGRAM MODE. ALL BREAKPOINTS ESTABLISHED BY THE AT COMMAND ARE REMOVED.TEST AND ASSOCIATED WORKAREAS ARE DELETED. EXECUTION IN THE PROBLEM PROGRAM PROCEEDS FROM THE POINT OF LAST INTERRUPTION, OR TEST Page 236 TEST FROM THE INITIAL ENTRY POINT IF IT WAS LOADED BY TEST AND THIS IS THE FIRST EXECUTION, OR FROM THE SPECIFIED ADDRESS. SYNTAX - RUN 'ADDRESS' REQUIRED - NONE DEFAULTS - (RUN) WILL CAUSE EXECUTION OF THE PROBLEM PROGRAM TO PROCEED FROM THE POINT OF LAST INTERRUPTION, OR FROM THE INITIAL ENTRY POINT OF THE PROGRAM IF IT WAS LOADED BY TEST AND THIS IS THE FIRST EXECUTION. NOTE - RUN TO OVERLAY PROGRAMS IS NOT ALLOWED, USE THE GO SUBCOMMAND. OPERANDS - 'ADDRESS' - THE ADDRESS WHERE EXECUTION SHOULD BEGIN IN THE PROBLEM PROGRAM. FOR A MORE DETAILED DISCUSSION OF THE DIFFERENT TYPES OF ADDRESSES ENTER - HELP GO OPERANDS SUBCOMMAND WHERE (MAY BE ABBREVIATED W) FUNCTION - THE WHERE COMMAND IS USED TO FIND LOCATIONS WITHIN THE LOADED PROGRAM OR THE CONTENTS OF THE INSTRUCTION COUNTER. SYNTAX WHERE 'LOADNAME'.'CSECTNME'.'RELADDR'/'ADDRESS' REQUIRED - NONE DEFAULTS - IF NO PARAMETERS ARE SPECIFIED, THE CURRENT INSTRUCTION COUNTER IS DISPLAYED. ALIAS- W OPERANDS - 'LOADNAME' - THE LOAD MODULE NAME FOR WHICH THE ABSOLUTE ADDRESS IS TO BE PRINTED. 'LOADNAME' MAY BE USED IN COMBINATION WITH 'CSECTNME' OR 'CSECTNME'.'RELADDR' 'CSECTNME' - THE ENTRY POINT NAME FOR WHICH THE ABSOLUTE ADDRESS IS TO BE PRINTED. IT MAY BE SPECIFIED BY ITSELF, OR IN COMBINATION WITH 'LOADNAME' OR 'RELADDR' OR BOTH 'RELADDR'- THE RELATIVE ADDRESS FOR WHICH THE ABSOLUTE ADDRESS AND OFFSET IN THE LOADED PROGRAM IS TO BE PRINTED. 'RELADDR' MAY BE SPECIFIED BY ITSELF, OR IN COMBINATION WITH 'LOADNAME'.'CSECTNME' OR 'CSECTNME'. TEST Page 237 TEST 'ADDRESS'- THE LOADNAME.CSECTNAME IN WHICH THIS ADDRESS APPEARS PLUS THE OFFSET IN THE LOADNAME.CSECTNME WILL BE PRINTED. COMMAND NAME - TFORM FUNCTION - THE TFORM COMMAND PROVIDES EDITTING AND FORMATTING CAPABILITIES APPLICABLE TO TEXT-ORIENTED INPUT DATASETS. FROM A 'TEXT' INPUT DATASET, A 'LIST' TYPE DATASET IS CREATED. SYNTAX - TFORM 'DATASET NAME' PRINT('DATASET NAME' / *) ERRS('DATASET NAME' / *) / ERROR('DATASET NAME' / *) REQUIRED - 'DATASET NAME' DEFAULTS - PRINT(*) ERRS(*) NOTE - '.TEXT' WILL BE APPENDED TO THE INPUT DATASET NAME. '.LIST' WILL BE APPENDED TO BOTH THE OUTPUT AND ERROR DIRECTED DATASET NAMES. OPERANDS - 'DATASET NAME' - THE NAME OF AN INPUT DATASET TO BE FORMATTED AND EDITTED. PRINT('DATASET NAME' / *) SPECIFIES THE NAME OF A DATASET INTO WHICH THE FORMATTED OUTPUT WILL BE PLACED. * - IS OPTIONAL AND SPECIFIES THAT THE PRINTED OUTPUT WILL BE DIRECTED TO THE TERMINAL. ERRS('DATASET NAME' / *) - SPECIFIES THE NAME OF A DATASET INTO WHICH THE ERROR MESSAGES WILL BE PRINTED. * - IS OPTIONAL AND SPECIFIES THAT THE ERROR MESSAGES WILL BE DIRECTED TO THE TERMINAL. TIME Page 238 TIME COMMAND NAME - TIME FUNCTION - THE TIME COMMAND INFORMS THE TERMINAL USER OF THE LOCAL TIME OF DAY, THE DATE, CUMULATIVE CPU TIME, SERVICE UNITS, AND THE TOTAL TIME THE THE USER HAS BEEN LOGGED ON THE TERMINAL DURING A SESSION. SYNTAX - TIME OPERAND - NONE REQUIRED - NONE DEFAULTS - NONE NOTE - ANYTHING IN THE OPERAND FIELD WILL BE IGNORED. COMMAND NAME - TSECAP FUNCTION - THE TSECAP COMMAND IS USED TO EXECUTE THE ECAP PROGRAM FROM A TERMINAL. SYNTAX - TSECAP 'DSNAME' REQUIRED - 'DSNAME' DEFAULTS - NONE ALIASES- NONE OPERANDS - 'DSNAME' - THE NAME OF THE DATA SET WHICH CONTAINS THE DATA TO BE ANALYZED BY THE ECAP PROGRAM. SUBCOMMANDS - NONE TYPE Page 239 TYPE COMMAND NAME - TYPE Function - The TYPE command is used to print the contents of a data set at high speed on a Diablo HyTerm (TM) or equivalent terminal. Syntax - TYPE'DSLIST' 'SEQ1' 'SEQ2' NUM/NONUM/SNUM INDEX('I') PAGE('P') LINECOUNT('K') EJECT FEEDER WAIT Required - 'DSLIST' Defaults - LINECOUNT(61) - NONUM is assumed if the data set contains printer control characters; NUM is assumed otherwise. Operands - 'DSLIST' - The name of the data set to be typed, or a list of names in parentheses. 'SEQ1' - The sequence number at which typing is to begin, rather than beginning at the first line of the data set. This parameter is ignored if NONUM is in effect. 'SEQ2' - The sequence number at which typing is to stop, rather than stopping at the last line of the data set. This parameter is ignored if NONUM is in effect. NUM - The data set contains sequence numbers. NONUM- The data set does not contain sequence numbers. SNUM - The data set contains sequence numbers which are not to be printed. INDEX('I') - Type each line indented I spaces from the left margin. PAGE('P') - Typing is to begin on page P of the data set. This parameter is ignored if the data set does not contain printer control characters to perform page ejects. LINECOUNT('K') - A form feed is to be done after every K lines of output. The top-of-form and the page length must be TYPE Page 240 TYPE set up on the terminal if this function is to work properly. This parameter is ignored if the data set does not contain printer control characters to perform page ejects when EJECT is not in effect. EJECT- A form feed is to be done before each data set is typed, and after the last data set has been typed. The terminal must be properly prepared as for LINECOUNT. FEEDER - A HyFeed (TM) cut sheet feeder (or the equivalent) is installed on the terminal, and special processing should be done to support it. WAIT - Typing is to stop after each form feed operation to allow the operator to load a fresh sheet of paper. Typing will continue when the operator presses carriage return. COMMAND NAME - UNPRESS FUNCTION - THE UNPRESS COMMAND IS USED TO CREATE A TSO OR OS FORMATTED DATASET FROM A WYLBUR COMPRESSED DATASET. SYNTAX - UNPRESS 'WYL-DSNAME' 'TSO-DSNAME' CARD VAR TXTF PRINT PLI ASA RECFM(''RECFM'') LRECL('N') BLKSIZE('N') SEQUENCED('A/B') NUMBERED UNNUMBERED NUMBER AT('N') BY('N') IBM SKIP('N') TAKE('N') LIST NOPRINT SLAC CODE('WORD') OPTIONS('LIST') REQUIRED - 'WYL-DSNAME' AND 'TSO-DSNAME' DEFAULTS - CARD IBM SEQUENCED(73/80) (NUMBERED ASSUMES SEQUENCED(73/80) AT(1) BY(1)) NOTE - IF 'TSO-DSNAME' IS AN OLD DATASET, UNPREDICTABLE RESULTS WILL OCCUR UNLESS IT HAS THE SAME FORMAT AS SPECIFIED IN THE COMMAND. OPERANDS - 'WYL-DSNAME' - THE NAME OF THE INPUT DATASET. UNPRESS Page 241 UNPRESS 'TSO-DSNAME' - THE NAME OF THE OUTPUT DATASET. CARD - THE OUTPUT DATASET WILL BE CARD IMAGE. (FB LRECL 80) VAR - THE OUTPUT DATASET WILL HAVE VARYING RECORDS. (VB LRECL 255) TXTF - THE OUTPUT DATASET WILL HAVE STANDARD IBM TEXT FORMAT. PLI - THE OUTPUT DATASET WILL HAVE STANDARD IBM PLI FORMAT. PRINT - THE OUTPUT WILL BE A PRINT DATASET. (LRECL 133) ASA - THE OUTPUT DATASET WILL HAVE ANSI PRINTER CONTROLS. RECFM(''RECFM'') THE OUTPUT WILL HAVE THE GIVEN RECORD FORMAT WHICH MUST BE ENTERED AS A QUOTED STRING WITH SPACES BETWEEN THE CHARACTERS. EXAMPLES: RECFM('F B A') RECFM('V B') LRECL('N') - THE OUTPUT DATASET WILL HAVE THE GIVEN LRECL. BLKSIZE('N') - THE OUTPUT DATASET WILL HAVE THE GIVEN BLKSIZE. SEQUENCED('A/B') - THE OUTPUT DATASET WILL HAVE SEQUENCE NUMBERS IN COLUMNS A THRU B. ANY INPUT IN THIS FIELD IS LOST. NUMBERED - THE OUTPUT DATASET WILL BE SEQUENCED IN COLS 73/80 UNNUMBERED - THE OUTPUT DATASET WILL BE UNNUMBERED. AT('N') - THE OUTPUT DATASET STARTING LINE NUMBER. BY('N') - THE OUTPUT DATASET LINE NUMBER INCREMENT. IBM - OUTPUT DATASET WILL HAVE IBM NUMBERS RATHER THAN WYLBUR STYLE. UNPRESS Page 242 UNPRESS SKIP('N') - SKIP 'N' LINE OF THE INPUT DATASET. TAKE('N') - UNPRESS 'N' LINES OF THE INPUT DATASET. LIST - LIST THE OUTPUT DATASET CREATED. NOPRINT - SUPRESS WYLBUR INFORMATORY HEADINGS. SLAC - THE INPUT DATASET HAS SPECIAL 'SLAC' NUMBERING. CODE('WORD') - THE INPUT DATASET IS SCRAMBLED ON KEY 'WORD'. OPTIONS('LIST') - OLD METHOD TO PASS PARMS TO UNPRESS. COMMAND NAME - WATFIV FUNCTION- THE WATFIV COMMAND INVOKES THE WATFIV COMPILER. SYNTAX- WATFIV 'SOURCE DSLIST'/* NOPRINT/PRINT('PRINT DSNAME'/*) NOPUNCH/PUNCH('PUNCH DSNAME'/*) LIB('LIB DSLIST') DEBUG/NODEBUG REQUIRED - 'SOURCE DSNAME' DEFAULTS - PRINT(*) NOPUNCH LIB('UICCAPP.WATLIB') NODEBUG ALIAS- NONE NOTE - UNIT 1 IS ASSIGNED TO THE TERMINAL FOR INPUT OR OUTPUT. OPERANDS 'SOURCE DSLIST'/* - THE NAME/NAMES OF THE FORTRAN SOURCE INPUT TO THE COMPILER. IT/THEY MUST BE OLD DATASET/DATASETS WITH A LOGICAL RECORD LENGTH OF 80. ANY QUALIFIER NAME MUST BE INCLUDED (IE. X.FORT). THIS ASSIGNS UNIT 5. AN '*' WATFIV Page 243 WATFIV WILL INDICATE INPUT FROM THE TERMINAL. NOTE - THE SOURCE DATASET MUST START WITH A $JOB CARD PRINT('PRINT DSNAME'/*) - THE NAME OF AN OUTPUT DATA SET. IT MAY BE OLD OR NEW. THIS ASSIGNS UNIT 6. PRINT(*) WILL DIRECT OUTPUT ON UNIT 6 TO THE TERMINAL NOPRINT - COMPILER MESSAGES AND OUTPUT ON UNIT 6 WILL NOT BE PRODUCED. PUNCH('PUNCH DSNAME'/*) - THE NAME OF AN OUTPUT DATA SET. IT MAY BE OLD OR NEW. THIS WILL ASSIGN UNIT 7. PUNCH(*) WILL DIRECT OUTPUT ON UNIT 7 TO THE TERMINAL. NOPUNCH - UNIT 7 WILL NOT BE ASSIGNED. LIB('LIB DSLIST') THE LIST OF DATASETS TO BE USED AS WATFIV SOURCE IT MAY BE CONCATENATED TO THE WATFIV RUNTIME LIBRARY. NODEBUG THE INTERACTIVE DEBUGGING FACILITY WILL NOT BE USED DEBUG THE INTERACTIVE DEBUGGING FACILITY WILL BE USED. COMMAND NAME - WPASCAL FUNCTION- THE WPASCAL COMMAND INVOKES THE WATERLOO PASCAL COMPILER. WPASCAL Page 244 WPASCAL SYNTAX- WPASCAL 'SOURCE DSLIST'/* PRINT('PRINT DSNAME'/*) SYSPRINT REQUIRED - 'SOURCE DSNAME' DEFAULTS - PRINT(*) ALIAS- NONE OPERANDS 'SOURCE DSLIST'/* - THE NAME OF THE PASCAL SOURCE INPUT TO THE COMPILER. ANY QUALIFIER NAME MUST BE INCLUDED (IE. X.PASCAL) PRINT('PRINT DSNAME'/*) - THE NAME OF AN OUTPUT DATA SET. IT MAY BE OLD OR NEW. SYSPRINT - COMPILER MESSAGES AND OUTPUT WILL BE ROUTED TO THE PRINTER. WPASCAL