This part contains format illustrations, descxiFtions, and examples of the use of the commands. 'Ihe cowmands appear in alphabetical order.
The symbol is used in the left-hand margin to help you find a corrmand.
If you do not need detailed information on the format of a command, but need only a review of the operands, you should turn tc Appendix G. You should review Part I before you look at the ccrrrrand descriptions if you are not familiar with the way commands are described in this book.
The forrrat illustration of some commands show all operands within brac-kets ([ ]). 'Ihis indicates that you do not have to enter any oFerand with the ccrrmand. The action that the system takes when you do net spe-cify an operand is discussed with the command. If an operand can be entered in keyword format, the keyword is shown in all-capital letters.
If an operand is in lowercase letters, you cannot use keyword notation.
ABEND Command
This command returns the user's task to the status that existed after the LOGCN process.
r---~---,
I operation I Operand I
~---+---i
I
L _________ ABEND ~I
____________________________________________________________ JI
Note: There are no operands.
Functional Description: When AEEN~ is executed, the current task is terminated. A new task is created, as if you had issued another LOGON comrrand. All data set definitions, open data sets, and task variables are elirrinated.
Note: If you issue the command DEFAULT DIAGREG=Y before you issue ABEND, the system displays general register contents following the
AEEND. The system default for DIAGREG is N.
Exarrple: 'Ierroination, using AEEND, is as follows:
,!;1ser:
systerr:
User:
systerr:
(press AT'IENTICN key once)
! abend
TAS}{ DELETED BY CC)!~AND
NEW TAS}{ LCGGED CN AT 11:12 ON 06/09/71. 'IAS}{I~
=
0020ABENDREG Ccrrmand
This command displays the contents of general registers when AEENC oc-curred and the location within your task where the ABEND ococ-curred.
r---T---,
I cperation I operand I
~---+---i
IABENDREG
I I
l _________ ~ ____________________________________________________________ J
Note: There are no operands.
Functional Cescription: After your task has teen abnormally terminated
h¥
the system, or after you have entered the ABEND command, you may use the ABENDREG command to display the general registers at the time termi-nation occurred. No display occurs if your task has not teen terrrinated abnormally.Example: Your task has just teen abnormally terminated, and you want to see the contents of the general registers at termination:
User: ~bendre9
System:
ABEND IN PRIV PRG CZASBC +000902, LAST USEF LOC AT CfAtBC +0003£8
USER GRS 003C.7A8 00007438 00113000 0001177A 00006BCO 00008058 00112000 00000017 00008054 OOS39DEC 0000804C 00006200 00011000 00007020 001125D8 00000008 PRIV GRS OOOOOOFF 000S98F8 00000008 00000048 00011140 00135E76 0013S_B8 0001C549 00000000 00001000 0042FOBC 001C68AC 000593A8 00059~40 001C6902 OOlBCOOO
ASM Command
This corrmand invokes the assemtler to assemble a source program module.
r---T---,
I Operaticn I Operand I
~---+---i
IASM lNAME=module namel,STCREC=IYIN}] I
I I (,MACROLIB=( {data definition name of symbolic portion, I I I data definition name of index portion} (,.,. ])] I I I [,VERID--version identification) l,ISD={YINl] [,SY~LIST={YINl) I
I I [,ASMLIST={YINl] [,CRLIS1={Y1NIE}) I
I I (,STEDIT={YINll[,ISDLIS1={YIN}l[,PMDLIS1={YI~l] I I I [,LISTDS={YINl] [,LINCR=(first line number,increment») I
l _________ L ____________________________________________________________ J
NAME
identifies the otject module to be created.
If the source program module (that is, the source language data set) is prestored, the user must have named i t SCURCE.name. If i t is nct prestored, the system automatically prefixes SOURCE. to the source program module name. 'Ihe listing data set is automatically named LIS1.name(O).
Specified as: the part of the source program module name that fol-lows SOURCE., if the source program is prestored: otherwise, any narre from one to eight alphameric characters long. 1he first character must be alfhatetic. The oeject module name must be unique to the library in ~hich i t is stored. See ~ssembler Pro-grarrrr.er's Glide for a complete list of naming rules.
S10RED
specifies whether or not the source frcgrarr nodule is prestored (that is, whether er not the data set SOURCE.narre exists).
Specified as:
Y - scurce program is prestored.
N - source program is not prestored.
Systen default: N.
MACRO LIB
specifies the data definition name ef the symbolic portion of the sUfplerr.entary macro litrary tc be used and the data definition name of the index porticn of that library. Both names must have been defined by DDEF conmands within the current task. The user can specify a maximum of six litraries (that is, six pairs of data
definition names), which are searched in the opposite order in which they were specified; the syste~ ~acrc li£rary <SYSMAC) is nade available to the user automatically and is searched last.
specified as: the data definition names defined in the teEF connands.
System default: only the systere n'acrc library is used.
VERID
ISD
specifies the version identificaticn to be assigned to the object progratr.
Specified as: fro« one to eight alphameric characters.
System default: the listing and the object «·odules are time stamped specifies whether an internal symbcl dictionary (ISD) is to be produced.
Specified as:
Y - ISD is produced.
N - 1St is not produced.
Syste« default: Y.
SYMLIST
specifies whether a syrrholic source program listing is to be produced.
Specified as:
Y - listing is produced.
N - listing is not produced.
syste« default: N.
ASMLIST
specifies whether an object progra« listing is to te produced.
Specified as:
Y - listing is produced.
N - listing is not produced.
syste« default: Y.
CRLIS'I
specifies whether a cross-reference listing is to te produced.
specified as:
Y - cross-reference listing is produced.
N - cross-reference listing is not produced.
E - cross-reference listing of only the symbols actually used is produced.
system default: N.
STEDIT
specifies whether the edited symbol table is to £e listed.
Specified as:
Y - edited symbol tane is listed.
N - edited symbol tatle is not listed.
Systerr default: N.
ISDLIST
specifies whether an ISD listing is tc be produced.
Specified as:
Y - ISO listing is produced.
N - ISD listing is not produced.
Systerr defau It: !Ii.
Pt-lDLIST
specifies whether a progran mcdule dicticnary (PMO) listing is to be prcduced.
sEecified as:
Y - PMO listing is produced.
N - PMC listing is not produced.
Systerr default: N.
LIS'IOS
LINCR
determines whether the user-requested listings from the assenbler are tc be placed in a list data set or are to be flaced directly on SYSOUT.
Specified as:
Y - listings are placed in list data set.
N - listings to SYSOU'I.
Systerr default: Y.
specifies the first line nun.ber of the SOurce language data set and the increwent to be applied to get succeeding line numters.
Specified as: two three- to seven-digit decimal numbers, separated by a comma and enclosed in parentheses; the last two digits in each number must be zeros.
System default: (100,100) •
Note: This operand is ignored when STOREC=Y.
There is also an operand called the ASMALIGN cperand. ASMALIGN is not an operand of the ASM command, tut is instead an implicit operand (Sec-tion 6, Part II explains implicit operands). ASMALIGN controls the ali-gnment of the sour~e statements in the assembler list data set.
If you issue DEFAULT AS~ALIGN=Y prior to issuing the ASM command, all names, operation codes, and operands in your source code will be aligned in colunns 1, 10, and 16 (respectively) in the list data set. ASMALIGN=
Y is the system default; if you desire alignment and haven't specified otherwise, alignment is automatic. However i f you do not want your source statements aligned, issue DEFAULT ASMALIGN=N prior to issuing the ASM command, and your source statements will appear in the list data set
just as you entered them.
Functional Description: See -Language Processing- in Section 3 of Part II.
caution: The command is canceled if invalid operands are entered.
Examples: (refer also to Assembler prograrrmer's Guide)
1. The user wants to assemble a frestored scurce ~rogram (SOURCE.
IRISH); he wants an ISD and a source program listing:
User: asm irish,y,isd=y
The system assemtles the program SOURCE. IRISH and acknowledges suc-cessful assembly by prompting with an underscore.
2. The user wants to assemble a program as he enters it. The ccrrrrands
STATEMENT CONTAINS INVALID CHARACTER
LR 13,%
00001600 end
Next, the user defines a macro instruction library index and calls SYSINDEX.
User: ddef inde x, vs ,mynd x' sysindex
The system prompts the user for control statenents.
header=),length=8
~srn lfiYFrog,y, (source, index)
~he user assembles his progran.
AT Conn and
~his command requests notification when executicn of an oeject program reaches specific instruction locations. AT also designates the otject progratr instruction locations at which the cowmands following A~ in the dynamic statement are to be executed.
r---T---,
I operation loperand I
~---+---~
IA'I linstruction location[, ••• ] I
L _________ ~ ____________________________________________________________ J
instruction location
specifies the location of an instruction within an oeject module.
Specified as: an internal or external symbol. with or without off-set cr subscript, or a hexadecimal address.
Functional Description: AT cecomes effective when control arrives at the instruction location specified in the operand, cut eefore the in-struction at that location is executed. A command statement containing an AT is called a dynamic statement. Only one ~T nay ce included in a dynamic statement, and it must te the first command in the statement.
(See RUse of Command statements· in Section 3 of Part II. Note the list of comrands that can be used after AT.) The system assigns a number to each dynaIric statement. This number may be referenced by the REMCVE cororrand.
when an A'1 cOIrrrand is executed, a standard output (including the in-struction location where the command became effective, program status information, and the staterr,ent number is Fresented to the user. If LIMEN is not set to I, cnly the dynamic statenent nurreer is disFlayed.
If the AT is a conditional statement, the dynamic statement number is displayed only if the condition is true. '1he program status infornation includes the virtual storage location of the instruction ceing executed, the instruction length code, the condition code, and the program nask.
If the user refers to an instruction location in a shared program or in a system program, a diagnostic message is issued, and the command is ignored for that location. A diagnostic is also issued if the instruc-tion locainstruc-tion contains a supervisor call (SVC) operainstruc-tion requiring para-mEters that must follow the
svc.
The counter, referred to ty the speCial character %, is aSSigned to a dynamic state~ent and is incrementEd by one when the program arrives at an instruction location designated in the AT corrnand. 'The counter is increrrented even when the dynamic statement is conditional i f the
speci-fied location is reached. The counter Iray be used as an oferand in the other PCS commands within the ~tatement. The AT command alone ~ill
interrupt, but not stop, prog raIl' execution.
Specifications· in Section 3 of Part II.)
(See -Types of operand Caution: The user should not designate an instructicn location ttat was modified by program execution. If h~ does, the results are unpredict-able. Also, since PCS only checks that the AT location is on a halfword boundary, the user must te careful to put the A~ command at the begin-ning of an instruction, not in the middle.
prograrrrring Notes: If AT specifies FCRTRAN statement numbers as in-struction locations, the numbers must only designate executable FCRTRAN statEments.
~xa~: The user wants to be informed when his ~rcgraK reaches the locations PGM.Sl, PGM.S3. (4}, FTNPGM.98, and FTNPGM.98(S).
To acconplish this, User:
Syst~!!:
at pgm.sl,f9m.s3.(4),ftnpgrn.98,ftnpgrr.98(5) 00001
Execution of the prograrr begins. When control arrives at any of the in-struction looations, the user is notified. For example, the systen prints out the following line (assuming LIMEN=I) when i t reaches the third location specif ied in the connand:
AT FTNPG~.98 PSW 1 3 0 0003F076 0001 In this statement
F~NPGM.98 is the instruction location
PSW 1 3 0 003F076 is the program status
0001 is the statement number assigned ty the systerr
Note: If LIMEN had not teen set to I, only 0001 would have been printed by the system.
BACK connand
lhis command converts the user's conversational task to a nonconversa-tional task.
r---T---,
IcperationlOperand
I
~---+---f
I
L _________ BACK ~ IDSNAME=data set name __________________________________________________________ JI
DSNAME:
identifies the cataloged VSAM or VISAM line data set (new SYSIN) that contains the series of commands that complete the current task
in nonoonversational mode.
Specified as: a fully qualified data set name.
Functional Description: If space for a nonconversaticnal task is avail-able, the user's task is accepted for execution, and a batch sequence number (BSN) is assigned to th~ task. Control of the task is passed to a new SYSIN. The nonconversational task takes its commands from the SYSIN data set named in the BAC~ operand field. The SYSIN data set should conclude with a LOGOFF command; if i t does not, the system per-forms the LOGOFF operation and issues a diagnostic message.
If space for a nonconversational task is not available fcr the user's task, the EACK command is rejected. This allows the user to continue
his task in conversational mode, as though he had not issued the EACR command.
A BACR corrnand is not accepted if the system is being shut down.
caution: If Frivate devices are needed by a nonconversational task that is initiated by the BACR command, each device must be either: (1) as-signed to the task by an active data definition (DDEF), or (2) reserved by a SECURE command, which must be the first command (other than GC) of the SYSIN dataset.
prograrrning Notes: The BACR command is ignored by the system when i t is issued by a ncnconversational task.
After issuing the BACR command, the user must re-issue the LOGON conrrand to begin a ne~ conversational task.
If the .BACR command is rejected, the user can re-issue the command later. It reay be necessary to first modify the new SYSIN data set to reflect any further conversational processing that has been done.
If the user interrupts a program that is being executed when he issues the BACK command, the first command in his SYSIN data set should te GO, which causes prograro execution to resume at the point of interruption.
When the user wants to initiate a nonconversational task that does not require a prior conversational phase, he should use the EXECUTE corr~and.
The data set named as SYSIN in the EXECUTE oommand, unlike that named in the BACK command, must begin with LOGON and conclude with LOGOFF, and must be on public storage.
Exawple: ~he user wants to change his oonversational task to nonconver-sational, using the data set ALFHA as SYSIN for his nonconversational task. He issues the BACK command as follows:
User:
syste!!:
back alpha BSN=OOOl
TERMINAL LOGICALLY DISCONNECTED, RECONNEC~ OR HANG UP BEGIN COlurand
This command corulects the user's task to an MTT applicaticn prograu. run-ning under TSS.
r---~---,
\ Operation
I
operandsI
~---t---i
I
BEGIN lapplication narne{,application paraneters]I
l _________ ~ __________________________________________________________ J
application name
specifies the user-written application progran name.
Specified as: from one to eight alphameric characters,.
application parameters
specifies the user-written operand parameters (if any) that are entered according to the requirements of the application.
Note: The application program must define a means by which its current users may elect to be disconnected. Cnce the user is connected to the application program, any commands that have been defined by the applica-tion prograrr can be entered.
BLIP COltIl'and
The 'BLIP' command allows the user to receive assurance that thE system is still active and the terminal is connected. This command is 9nly valid for 2741's or their equivalent:
r---~---,
IOperationlOperand
I
~---+---~
I BLIP I 'IIME=,
*
READ=
IL _________ L ____________________________________________________________ ,
TIME
*READ
the decimal value given is the number cf seconds tetween the Sig-nals tc the user. If 0 is entered, no assurance signal will be given by the systen .•
Specified as: 0, cr 15 through 255 (seconds).
§ystem default: 30 (seconds).
If READ is specified and the terminal has the 'Receive Interrupt Feature' the system will interrupt a read request tc send thE assurance signal as long as tt:e user has not entered any data.
specified as:
Y - interrupt a read.
N
=
de not interruFt read.Systerr default: N
,functional Description: The system causes the type ball on the terlt·inal to 'wiggle' by transmitting alternating upper case - lcwer case shift characters.
~he period between the transmitting of the characters is deterroined by the 'TIME' parameter.
If ~~e ~IME is zero, then no transnission occurs.
If the user has specified READ=Y, and the terminal has the correct fea-ture, the system will interrupt a read to send the 'ball wiggle'
transmission.
The systeIr will not interrupt a read request if the user has started enter ing data.
prograIrlting Notes: The blip is supported only on 2141 type terminals.
If the user specifies READ=Y for a terminal without the correct feature, the system will attempt the character transmission, but because the ter-minal will be in the wrong mode, the ball wiggle will not be SEen by the user.
Also, any characters entered by the user during this period will ce lost.
The system attempts to prevent loss of data by not interrupting a read once the user has started entering data, but because of hardware con-straints, there is a very small period of time when the user may enter a character and the systeIl' will interrupt to send the '~all wiggle'; at that tilte. any data entered is lost.
Example: User enters:
ELIF 15
The system will blip-wiggle the type ball every 15 seconds as long as there are no other reads or messages to be written to the terminal.
If the user wishes to turn off the ball wiggle, he enters:
ELIP 0
The system will not wiggle the ball again until the user enters a new BLIP TIME value.
BLIP? Command
BLIP? is used to display the current BLIP settings.
r---T---,
IOperationlOperand
I
t---t---i
I L _________ BLIP? ~ I ____________________________________________________________ J I
Note: This command has no operands.
Functional Description: BLIP? will display the current ELIP settings in the following format:
CURRENT VALUES ARE:
TIME XX
READ ACTIVE/NOT ACTIVE
The time value is the deciIl'al number of seccnds between ELIPS. Read Ac-tive specifies that a read will be interrupted to cause the type ball to wiggle.
BRANCH Command
This command changes the control path of a );:rcgralr er resumes execution of a prograrr. at a different location.
r---T---,
I operation IOperand I
t---t---i
IBRA~CH IINSTLOC=instruction location IL _________ ~---_______________ J
INSTLOC
specifies the location of an instruction within an otject module at which execution is to resume.
Specified as: an ex);:licitly or implicitly qualified internal sym-bol, with or without offset; an external symsym-bol, with or without offset; er a hexadecimal address.
Functional Cescription: If the user has interrupted a program, BRANCH can oe used to resume execution of the program at a different location.
BRANCH Cdn also be used as part of a dynamiC statement to alter the path of a program.
Cautions: BRANCH should be the last command in a command statement con-taining more than one comIrand. If not, comranes that fcllow B~ANCH are ignored.
BRANCH cannct te used to initiatE Execution of a program.
progranning Notes: When the user wants to use internal symbols in the INSTLOC operand, he must have requested an ISO ~hen assemtling or con-piling his frogram.
f;xanples:
1. ~he user has stopped execution of his Frcgran (which has an ISO).
He wants to resume execution at an instruction location labeled with the internal sywbol LCCA. He issues the fcllcwing command:
User: branch pgm.loca
lhe system resumes execution at LOCA.
2. ~he user wants to alter the execution path of his program (PROG) fron lccation PTA to PTC. He issues the following command:
User: qualify [:rog
at pta; branch ptc prog
The system passes control to P~C when execution reaches PTA. (See
"Program Control" in Section 3 of Part II.)
"Program Control" in Section 3 of Part II.)