CP Command Reference for General Users (Rel 6 PLC 17 Apr81) Page 138 (150 of 213)

Now enter one of the following commands:
#cp set of 02 immed q rdr#q prt#q pun
-- or
cp set pf02 immed q rdr"#q prt"#q pun
or
set pf02 immed q rdr"#g prt"#q pun
and press the key. CP assigns the three OUERY commands as functions of the PF02 key.
Pressing the PF02 key executes the three QUERY commands.
Enter the following command while in CMS mode:
set linedit off
and press the ENTER key.
Then enter:
set pf02 immed q rdr#q prt#q pun
or
cp set pf02 immed q rdr#g prt#q pun
and press the ENTER key. CP assigns the three QUERY commands as functions of the PF02 key.
Then enter:
set line3it on
and press the key.
Pressing the PF02 key executes the three QUERY commands.
None.
138 IBM VM/310 CP Command Reference for General Users

SLEEP Use the SLEEP command to place the virtual machine in a dormant state
but allow messages to be displayed. You can specify a sleep interval in
the line and the virtual machine is awakened automatically when
the specified interval has elapsed. The of the SLEEP command is:
r , r r " , , ,SECII , SLeep I I nn I !1!.NI I , IHRsl1 L L .J..J L
r r " I ISECII ,nn I 111.N1 I I !H1sll L L J J
indicates the number of seconds, minutes, or hours, measured by the clock, that the virtual machine is to
remain dormant. The value nn can be any decimal number from 00 through 99. If you specify no time unit, the value of nn
is taken to be in minutes.
1. During the dormant period, the virtual machine does not run but time is still being counted.
2. The terminal can be awakened at any time by signaling attention.
3. If n) interval is specified, the virtual machine remains dormant
until awakened by signaling attention.
4. If y)U issue the SLEEP command from a CP read or from a VM read
using the CP "escape" function (ICP SLEEP), the end of the time interval or signalinq attention returns you to the CP environment.
5. If y)U issue the SLEEP command while in virtual machine mode (for
examole, execution of the command line CP SLEEP), the end of
the time interval or signaling attention returns your terminal to virtaal machine mode without entering the CP environment.
6. The SLEEP command, with the time interval, is a convenient way to delay or schedule the execution of certain jobs that could be run more efficiently at a later time; for example, second shift. None. section 5. Format of CP Commands 139

Previous Page Next Page

Extracted Text (may have errors)

Now enter one of the following commands:
#cp set of 02 immed q rdr#q prt#q pun
-- or
cp set pf02 immed q rdr"#q prt"#q pun
or
set pf02 immed q rdr"#g prt"#q pun
and press the key. CP assigns the three OUERY commands as functions of the PF02 key.
Pressing the PF02 key executes the three QUERY commands.
Enter the following command while in CMS mode:
set linedit off
and press the ENTER key.
Then enter:
set pf02 immed q rdr#q prt#q pun
or
cp set pf02 immed q rdr#g prt#q pun
and press the ENTER key. CP assigns the three QUERY commands as functions of the PF02 key.
Then enter:
set line3it on
and press the key.
Pressing the PF02 key executes the three QUERY commands.
None.
138 IBM VM/310 CP Command Reference for General Users

SLEEP Use the SLEEP command to place the virtual machine in a dormant state
but allow messages to be displayed. You can specify a sleep interval in
the line and the virtual machine is awakened automatically when
the specified interval has elapsed. The of the SLEEP command is:
r , r r " , , ,SECII , SLeep I I nn I !1!.NI I , IHRsl1 L L .J..J L
r r " I ISECII ,nn I 111.N1 I I !H1sll L L J J
indicates the number of seconds, minutes, or hours, measured by the clock, that the virtual machine is to
remain dormant. The value nn can be any decimal number from 00 through 99. If you specify no time unit, the value of nn
is taken to be in minutes.
1. During the dormant period, the virtual machine does not run but time is still being counted.
2. The terminal can be awakened at any time by signaling attention.
3. If n) interval is specified, the virtual machine remains dormant
until awakened by signaling attention.
4. If y)U issue the SLEEP command from a CP read or from a VM read
using the CP "escape" function (ICP SLEEP), the end of the time interval or signalinq attention returns you to the CP environment.
5. If y)U issue the SLEEP command while in virtual machine mode (for
examole, execution of the command line CP SLEEP), the end of
the time interval or signaling attention returns your terminal to virtaal machine mode without entering the CP environment.
6. The SLEEP command, with the time interval, is a convenient way to delay or schedule the execution of certain jobs that could be run more efficiently at a later time; for example, second shift. None. section 5. Format of CP Commands 139

Help

SMSG nse the command to send a special message to a virtual machine proqrammed to accept and process the message. The format of the SKS3 command is:
r----------T ---, , S Msq I userid msgtext , L __________ .L ___ J user id is the receiving aserid as "*", yourself. virtual machine's logon ID; if you specify
it indicates the message is to be sent to
msqt ext is the text of the message that is to be transmitted. Because
the input baffers on various console devices differ, the
length of the message is limited by the number of characters
remaining on the input line after entering the command and the aserid. For example: A 3270 display device contains a 139
character input buffer. If you enter:
1 • smsg pd58gh1c --------- 14 characters used
sm u '-v--' 5 characters used
special message ------------- 125 characters left
special message ---------- 134 characters left NQtg: the 3270 display unit contains 139 characters
in its input area, CP only reads 134 characters of data. When the SMSG command is issued using DIAGNOSE X'08', only 132
characters are read by CP. Special messages do not appear on the specially programmed
machine's· screen because the messages are designed instcactions that are passed as data parameters. The messaqes are stored in the prespecified VMCF data receiving
they are received, and the instructions are processed
pcoqrammed virtual machine.
virtual
to be
special
area as
by the
2. Virtlal machines can only receive and process special messages ander these two conditions: (1) the virtual machine has issued the SET SMSG command, and (2) the user wishing to receive special messaqes has issued an AUTHORIZE with the Virtual Kachine Cornm'lnication Facility (VMCF) of VM/370. Refer to §y!gg for more
information on the AUTHORIZE function of VMCF. None lUO Reference for General Users

SPOOL Use the SPOOL command to modify the spooling control options in effect
for a given virtual spooling device or for a group of devices. The SPOOL command can also start or stop the spooling of virtual console
input and output. You can direct a file to a remote location by using
the SPOOL command in conjunction with the TAG command. This latter
function is discussed below in the section "Transmitting Files to Remote
Locations." The default values for this command appear under "Usage Notes" following the operand descriptions. The format of the SPOOL command is: SPool {
Reader}
vaddr
{
printer} PUnch vaddr
rr ,
r , r , r , ICONt I IHOld I IEOF I I NOConil INOHoldl INOEofl L .J L .J L .J , r , r , IIIQ I{USerid I' For, * I L .JSYSTEM }
'IHOld IlcONt I ,!NOHoldl I L J L .J , I I I I OFF L
r , 1CLOSE I IPURGE I L .J I I .J
r , IFLash name nn21 IMOdify name
3 I IChars name
3 I IFCB name
3 I L .J
c]
[ COpy[ * ]nn ]2
(
r , r , r , {
CONsole) ,STArt, IHOld I ICONt , vaddr J ISTOp I INORoldl r ,rr, , ITErm II ITo I(userid) I iNOTEr ii IFori< * L .JIL J{SYSTEM) I L .J L .J L .J
r CLass c] [COpy[ * ]nn ]
r , I FLash name nn2' IMOdify name
3 I IChars name
3 I I FCB name
3 I L .J
r , I I ICLOSEIIOFF I IPURGEIL .J
L .J
tAt least one of the options within braces must be selected; however,
more than one may be specified, and they may be entered in any order
on the command line.
2These options can only be used to modify a virtual spooling printer
Furthermore, these options only apply to a 3800 printer as a virtual
spooling device. 13You can specify NULL for the name field to nullify any previous or I existing settings of the MODIFY, CHARS, or FCB operands. NULL 1 is the default. L--- Section 5. Format of CP Commands 141

Previous Page Next Page

function, the existence of blanks preceding the keyword TAB or
the lack of trailinq tab settings forces the pf key to be
treated as ufdata. PFnn [COPY [resid]l
specifies that the program function key numbered nn performs a COpy function for a remote 3270 terminal. The number, nn,
must be a value from 1 (or 01) to 12. The COPY function a printed output of the entire screen display at the
time the PF key is actuated. The output is printed on an IBM printer connected to the same control unit as your display terminal. The resource identification, resid, may be
specified if more than one printer is connected to the same
control unit as your display terminal. It is a
three-character hexadecimal resource identification number
assigned to a specific printer. If resid is entered, the
printed copy is directed to a specific printer; if not, the copy is printed on the printer with the lowest resid number.
The resid numbers of the printers available to your display terminal can be obtained from your system operator. If only
one printer is available, as with the 3275 Display Station,
resid need not be specified. PFnn [COpy [cuu]]
specifies that the designated program function key, PFnn, performs a COpy function for a local 3270 terminal. The
numher of the PF key, nn, must be a value from 1 (or 01) to
12. When the PF key is pressed, the function produces a
printed outuut of the entire local screen display except for
the status field, which is replaced with blanks. The cuu
represents the real hardware address of the display printer,
and may specify a printer that is on a different control unit
than the one to which your 3270 is attached. If you do not
specify cuu, the printer with the lowest cuu that is available
on the same control unit as your 3270 is selected. For both remote and local COpy functions:
1. receive a NOT ACCEPTED message, displayed in the screen status field of your 3270, if any of the following situations occur: • The printer is already busy, or all printers are busy. • The printer is turned off. • The printer is operational but has not been varied online by the
system operator. • The printer is out of paper
intervention-required condition.
or is in any other • The designated device is not a 3284/3286/3287/3288/3289 printer. • The SET PFnn COPY command format is invalid.
2. You include your own identification on the printed output by enterinq the data into the user input area of the screen before you press the OF key. The identification appears on the last two lines
of the printed copy.
136 VM/370 CP Command Peference for General Users

SET 3. To ensure the definition of a pf key for the COpy function, you can
either start with one leadinq blank before the keyword COpy or follow the keyword with at least five blanks.
4. The existence of more than one data fileid (cuu or residt following
the keyword Cooy, identifies the string as pfdata rather than a
hardcopy request.
1. System values for SET operands or the values set by previously invoken SET command operands can be dgtermined by the
use of the QUERY command.
2. SET rIMER REAL must be specified if an interrupt-driven system such as Customer Information Control System (CICS) is to be run in a
virtual machine. 3. Both SET PFnn TAB and SET PFnn COpy are executed immediately upon
pressing the appropriate program function key. If you insert the keywor1s DELAYED or IMMED after the PFnn operand, the command is
accepted, but the keyword is ignored. The program function still
executes immediately.
4. In the case of systems with attached processors, the VM/370 assists may be installed on none, one, or both processors. Similarly, hardware assist, if equipped on both processors of an
attached processor system, can be activated for none, either, or
both systems by the system operator. Thus, with the AFFINITY setting of a virtual machine, the user can receive no response
indi:ating that VM/370 hardware assist is installed and active on
his pro:essor. In attached processor setups where the user has no
processor preference (AFFINITY=NONE) upon entering SET ASSIST he too receives no response if either processor has VM/370 hardware
assist active. Any error message is indicative that VM/370 assist is not available or active for user. If the user
receives a message indicating that VM/370 hardware assist is not
available on a particular processor it is also implying that it is
available on the other processor. Therefore, the user, to take advantage of VM/370 hardware, need only change his affinity
setting, then initiate the SET ASSIST command. If you use the SET PFnn command to set up a series of concatenated you should be careful of line-editing characters. The examples demonstrate two methods for entering a series of
commands:
6. The SET RUN ON command should be issued before the user issues an ADSTC>P command.
Enter the following command while in CMS mode:
set linedit on
and press the ENTER key.
section 5. Format of CP Commands 137

Previous Page Next Page

Page 3Section 1. The VM/370 Command Languages click to expand contents

Page 7Section 2. The CP Command Language click to expand contents

Page 13Section 3. CP Command Usage click to expand contents

Page 35Part 2. Reference Information click to expand contents

Page 41Section 5. Format of CP Commands click to expand contents

Page 173Appendix. VM/370 Command Summary click to expand contents

Extracted Text (may have errors)

Help

loading