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

IPL NQtg: You cannot load a shared system or one that uses disGontiguous saved segments into a virtual machine running in
the V=R area. An attempt to do so results in an error
message. PARM {p1 p2 ••• 1 passes up to 64 bytes of data (excluding the first blank
character after the keyword, PARM, but including all other
embedded blanks) to your virtual machine's general registers (4 bytes per register), starting with the high order byte of
general register o. since the registers are not cleared
before use, the PARM value should be some multiple of 4 bytes
to avoid having extraneous characters present in the low order
positions of the register. For example, you could key in PARr; eMSj) where represents a blank to ensure that the loy. ornAr positions of register 0 contain a hexadecimal 40. Whenever is specified, the remaining characters in the command
line are treated as parameters to be passed to your virtual
machine; therefore, PARK must be the last operand entered on
the command line.
1. IPL simulates the LOAD button and the device address switches on
the real computer console. The specified virtual address is
accessed and the required input/output operations are performed to
retrieve the IPL data.
2. the IPL procedure can be stopped just before loading
the virtual PSW except when initial program loading a named system.
Also, parameters can be passed to the virtual machine's general
registers. When the simulated load function is complete, CP initiates execution of the virtual machine by loading the 1PL PSi which was stored during the simulation process.
3. Care must be used when passing parameters to a named system (systemname). Named systems expect certain registers to be
initialized when they are given control. Indiscriminate use of the operand could overlay a previously initialized register
causing unpredictable results. 4. The IPL simulator program occupies one page (4096 bytes) of storage in your virtual machine. Therefore, if the system being loaded
utilizes data remaining in storage by the previous system, care
should be taken as to where that data is located. The starting
address of the overlaid virtual storage is: 256K and above
Less than 256K
For example:
= 1/2 the storage size
storage size=200K then the IPL Simulator is loaded at 100K. Section 5. Format of CP Commands 89

IPL 5. Any logical lines following the 1PL command are ignored since the execution of the IPL command transfers control from the CP environment to the virtual machine environment.
6. Some CMS routines and programs are stored on disks and loaded into storage as needed. Since this storage area is not contiguous with your virtual storage, the saved segments that are loaded in this area are called discontiguous segments (DCSS). However, the only saved segment a CMS user can replace is the CftSSE3 seqment. The user can indicate an alternate segment to be loaded bV issuinq an IPL command with this format: IPL {CUU .} PARM SEG=segmentname
systemname
SEG=segmentname
indicates the name of the saved segment to be loaded whenever
the CMS Editor, EXEC processor, or as simulation routines are
needed. Eiqht characters must be entered for segmentname;
either assiqn an 8-character segment name when you code the macro for your installation, or be sure that the
operator enters trailing blanks if segment name is less than eight characters long.
The CMS batch facility loads whatever segment is specified
on the first IPL command issued for the batch virtual machine. Thus, if the first 1PL command for a CKS batch facility machine is: 1Pt CMS PARM SEG=CMSSEG02 all subsequent IPL commands issuej by the CftS batch facility specify the same segment name (CMSSEG02). 7. The option in the PARM operand indicates that the :ftS initial proqram load is beinq performed in a batch instead of an int.eractive virtual machine. This option causes the :KS nucleus to issue the CMSBATCH command to load the batch processor. Specifying
the option eliminates the need for operator intervention
between jobs. Consult VM/370 gng for
information on the CMSBATCH facility.
8. CMS users can use the PARM operand to pass the AUTO:R (automatic
carriage return) option to the CMS initialization routine. AUTOCR simulates the pressing of the ENTER key as input to the virtual
machine. This results in automatic execution of the user's PROFILE EXEC, if it exists on virtual minidisk 191.
Note: For a disconnected CMS service virtual machine, this mechanism can prove to be very useful. The name of a :MS restart may be specified in the CMS nucleus. In the event of an
ABEND, the specified restart routine receives control instead of
the service virtual machine entering a disabled wait state. If
this routine issues an 1PL eMS PARM AUTOCR command, the PROFILE EXEC executes initial setup procedures that allow the service virtual machine to reestablish itself.
After a successful 1Pt, any responses you receive are those from the operating system that was loaded and initialized. 90 VM/370 CP Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

IPL Use the IPL =ommand to simulate an initial program load function for a
virtual machine. The format of the 1PL command is: r I 101 I , , I L r , ,CLear , vaddr [cylno 1 I I (STOP] L oJ system name r , [PARM {p1 p2 ••• l] --, I I I I I _______________________J vaddr rcvlnol ICLEAR , rSTOPl vaddr
cvlno
CLEAR STOP syst emname
L .J
simulates the IPL function when loading by device address.
is the virtual address (cuu) of the device that contains the
nucleus to be loaded.
is the cylinder containing the IPL data. If this operand is
specified, CP loads the IPL data from the specified virtual instead of from virtual cylinder zero. Virtual cylinder zero is the default when cylno is not specified.
This operand is valid only for virtual direct storage devices.
sets the virtual storage space to binary zeros before the
operating system is loaded. This operand is invalid if you a svstemname in the IPL command line.
allows the contents of your virtual storage space to remain
unchanqed prior to program load. This operand is invalid if you soecify a systemname in the IPt command line. NO:LEAR is
the default if you IPL by device (vaddr).
halts the virtual machine during the IPL procedure just before
the initial PSW is loaded. It provides the virtual simulation
of the IPL procedure for a real machine in instruction step mode. The STOP operand is invalid if systemname is specified
in the IPL command. When the virtual machine stops, you can
issue CP commands. For example, if you are loading OS or OS/VS into your virtual machine, you can use CP commands to store data into low storage, to load an alternate nucleus, or to
alter the apparent size of virtual storage. To restart the
virtual machine, issue the BEGIN command.
simulates the IPL function when loading a named system that
was previously saved via the SAVESYS command. It is loaded
into virtual storage and qiven control. For information about
saved systems, see the 88 VM/370 CP Command Reference for General Users

IPL NQtg: You cannot load a shared system or one that uses disGontiguous saved segments into a virtual machine running in
the V=R area. An attempt to do so results in an error
message. PARM {p1 p2 ••• 1 passes up to 64 bytes of data (excluding the first blank
character after the keyword, PARM, but including all other
embedded blanks) to your virtual machine's general registers (4 bytes per register), starting with the high order byte of
general register o. since the registers are not cleared
before use, the PARM value should be some multiple of 4 bytes
to avoid having extraneous characters present in the low order
positions of the register. For example, you could key in PARr; eMSj) where represents a blank to ensure that the loy. ornAr positions of register 0 contain a hexadecimal 40. Whenever is specified, the remaining characters in the command
line are treated as parameters to be passed to your virtual
machine; therefore, PARK must be the last operand entered on
the command line.
1. IPL simulates the LOAD button and the device address switches on
the real computer console. The specified virtual address is
accessed and the required input/output operations are performed to
retrieve the IPL data.
2. the IPL procedure can be stopped just before loading
the virtual PSW except when initial program loading a named system.
Also, parameters can be passed to the virtual machine's general
registers. When the simulated load function is complete, CP initiates execution of the virtual machine by loading the 1PL PSi which was stored during the simulation process.
3. Care must be used when passing parameters to a named system (systemname). Named systems expect certain registers to be
initialized when they are given control. Indiscriminate use of the operand could overlay a previously initialized register
causing unpredictable results. 4. The IPL simulator program occupies one page (4096 bytes) of storage in your virtual machine. Therefore, if the system being loaded
utilizes data remaining in storage by the previous system, care
should be taken as to where that data is located. The starting
address of the overlaid virtual storage is: 256K and above
Less than 256K
For example:
= 1/2 the storage size
storage size=200K then the IPL Simulator is loaded at 100K. Section 5. Format of CP Commands 89

Help

LINK Use the command to make a device that is associated with another
virtual ava1laDle to your configuration, based
upon information in that user's VM/370 directory entry. The format of
the LINK command is:
r
\ LINK [Tol userid vaddr1 (Asl vaddr2 [mode] [[PASS=] passwqrd 1 ]
\----
\ I1If your installation is using the password suppression facility, an I INVALID message is issued when a user attempts to enter the
\ for a DASD device on the LINK command line. The user must I wait for the EN1ER PASSWORD response before typing in the password. I This facility improves system security because the password I is automatically masked.
L [TOl userid
vaddr1
is the name of the user whose directory is to be
searched for device vaddr1. An asterisk (*) is used to specify
that the device is in your own VM/370 directory. If the keyword TO is omitted, the userid may not be "TO" or "T".
is the virtual device address (cuu) in the VM/370 directory
for that userid. [ASl vaddr2 mode
is the virtual address (cuu) that is to be assigned to the ievice for vour virtual machine. If the keyword AS is omitted, vaddr may not be "AS" or "A". If your virtual machine has the option, any address up to X'FPF' is valid; otherwise, any address up to X'5FP' is valid.
is the access mode; the primary access requested (read-only, write; or multiple) I and the alternate access (read-only or write) desired if the primary access is not available. Valid modes are: R access. The link is not done if any other user
has the disk in write status. R is the default mode if
the link is to another userid.
RR Read-onlv access. The link is established even if another
user has the disk in write status. w write access. The link is not done if any other user has the disk in read or write status. WR write and read access. If another user has the disk in
read or write status, an alternate access of read-only is
acceptable. M access. This means that a write-link is to be
given to the disk unless another user already has write
access to it, in which case no link is to be done.
section 5. Format of CP Commands 91

MF write-link. If another user already has write access to
the disk, a read-link is to be done. Note: Unpredictable results can occur when one user has a RIO-link to a device that is being updated by a user who
has the device in read/write status. MW Write-link. This link is established in all cases. More than one user writing to the same virtual device
can result in permanent loss of data.
If the mode is omitted, the default is R if the userid is
another user. If you are linking to one of your own disks,
the default is the "user access mode" as specified in the VM/370 directory for your disks. PASS= password is a one-to eight-character string that must match the access mode password for device vaddr1 in the VM/370 directory for
the user (userid) specified. The password should be specified only when the LINK is executed by a virtual machine (for
example, from CMS), since printing of the password is not
suppressed when included with the LINK command. The access
mode password cannot be the same as any of the access modes
(R, RR, W, WR, M, MR, or Mi) if the default mode is to be used. The access mode password should not be confused with a
user password.
1. If link to one of your own disks, no password is required.
Also, if the link is to a device whose password is ALL, meaning
that the device can be used by all users, the password is not
required. if the link is to any other userid, a password
for the desired device must be provided. If a LINK command is
issued from a CMS batch job, a password must be provided, even if
the device password is ALL.
2. When linking to a 2305 device, you gain access only to the virtual address specified and not to all eight addresses associated with
the device. 3. The access allowed by the LINK command to the vaddr1 device
belonqing to userid is summarized below. You read the columns down
to deteLmine the type of link that results. The first row
indicates the primary (and, optionally, the alternate) access mode
requested. The second row indicates whether read, write, or
multiple passwords exist in the VM/370 directory for the disk being
linked. The third row indicates whether the disk is already being
used, and if so, the mode of its access. The last row indicates
the type of link established. For example, the third column is inteLpLeted as follows: if you request a read access link (R) to a
disk that has a read password defined and that already is accessed
in read mode, you can establish a read link.
4. ViLtual Leserve/release processing cannot be requested by appending
a V to the mode operand of the LINK command line. Virtual reseLve/release processing can only be requested by means of the MDISK statement of the directory program. 92 IBM CP Command Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

IPL 5. Any logical lines following the 1PL command are ignored since the execution of the IPL command transfers control from the CP environment to the virtual machine environment.
6. Some CMS routines and programs are stored on disks and loaded into storage as needed. Since this storage area is not contiguous with your virtual storage, the saved segments that are loaded in this area are called discontiguous segments (DCSS). However, the only saved segment a CMS user can replace is the CftSSE3 seqment. The user can indicate an alternate segment to be loaded bV issuinq an IPL command with this format: IPL {CUU .} PARM SEG=segmentname
systemname
SEG=segmentname
indicates the name of the saved segment to be loaded whenever
the CMS Editor, EXEC processor, or as simulation routines are
needed. Eiqht characters must be entered for segmentname;
either assiqn an 8-character segment name when you code the macro for your installation, or be sure that the
operator enters trailing blanks if segment name is less than eight characters long.
The CMS batch facility loads whatever segment is specified
on the first IPL command issued for the batch virtual machine. Thus, if the first 1PL command for a CKS batch facility machine is: 1Pt CMS PARM SEG=CMSSEG02 all subsequent IPL commands issuej by the CftS batch facility specify the same segment name (CMSSEG02). 7. The option in the PARM operand indicates that the :ftS initial proqram load is beinq performed in a batch instead of an int.eractive virtual machine. This option causes the :KS nucleus to issue the CMSBATCH command to load the batch processor. Specifying
the option eliminates the need for operator intervention
between jobs. Consult VM/370 gng for
information on the CMSBATCH facility.
8. CMS users can use the PARM operand to pass the AUTO:R (automatic
carriage return) option to the CMS initialization routine. AUTOCR simulates the pressing of the ENTER key as input to the virtual
machine. This results in automatic execution of the user's PROFILE EXEC, if it exists on virtual minidisk 191.
Note: For a disconnected CMS service virtual machine, this mechanism can prove to be very useful. The name of a :MS restart may be specified in the CMS nucleus. In the event of an
ABEND, the specified restart routine receives control instead of
the service virtual machine entering a disabled wait state. If
this routine issues an 1PL eMS PARM AUTOCR command, the PROFILE EXEC executes initial setup procedures that allow the service virtual machine to reestablish itself.
After a successful 1Pt, any responses you receive are those from the operating system that was loaded and initialized. 90 VM/370 CP Reference for General Users

LINK Use the command to make a device that is associated with another
virtual ava1laDle to your configuration, based
upon information in that user's VM/370 directory entry. The format of
the LINK command is:
r
\ LINK [Tol userid vaddr1 (Asl vaddr2 [mode] [[PASS=] passwqrd 1 ]
\----
\ I1If your installation is using the password suppression facility, an I INVALID message is issued when a user attempts to enter the
\ for a DASD device on the LINK command line. The user must I wait for the EN1ER PASSWORD response before typing in the password. I This facility improves system security because the password I is automatically masked.
L [TOl userid
vaddr1
is the name of the user whose directory is to be
searched for device vaddr1. An asterisk (*) is used to specify
that the device is in your own VM/370 directory. If the keyword TO is omitted, the userid may not be "TO" or "T".
is the virtual device address (cuu) in the VM/370 directory
for that userid. [ASl vaddr2 mode
is the virtual address (cuu) that is to be assigned to the ievice for vour virtual machine. If the keyword AS is omitted, vaddr may not be "AS" or "A". If your virtual machine has the option, any address up to X'FPF' is valid; otherwise, any address up to X'5FP' is valid.
is the access mode; the primary access requested (read-only, write; or multiple) I and the alternate access (read-only or write) desired if the primary access is not available. Valid modes are: R access. The link is not done if any other user
has the disk in write status. R is the default mode if
the link is to another userid.
RR Read-onlv access. The link is established even if another
user has the disk in write status. w write access. The link is not done if any other user has the disk in read or write status. WR write and read access. If another user has the disk in
read or write status, an alternate access of read-only is
acceptable. M access. This means that a write-link is to be
given to the disk unless another user already has write
access to it, in which case no link is to be done.
section 5. Format of CP Commands 91

INDICATE is your total virtual machine time since you logged
on or since the last ACNT command was issued for your
virtu al mach ine. TTTME=mmm:ss is your total virtual machine time plus total
processor time (virtual plus overhead) that you have
used lVU loqged on S1nce the last leNT command was issued for your virtual machine. SIO=nnnnnn is the total number of nonspooled I/O requests that
you have issued since you logged on or since the last ACNT command was issued for your virtual machine.
RDF-nnnnnn is the total number of virtual cards read since you loqged on or since the last ACNT command was issued
for your virtual machine.
PRT-nnnnnn PCfl-nnnnnn is the total number of virtual lines printed S1nCe you logged on or since the last ACNT command was
issued for your virtual machine.
is the total number of virtual cards punched since
you logged on or since the last ACNT command was
issued for your virtual machine.
Section 5. Format of CP Commands 87

IPL Use the IPL =ommand to simulate an initial program load function for a
virtual machine. The format of the 1PL command is: r I 101 I , , I L r , ,CLear , vaddr [cylno 1 I I (STOP] L oJ system name r , [PARM {p1 p2 ••• l] --, I I I I I _______________________J vaddr rcvlnol ICLEAR , rSTOPl vaddr
cvlno
CLEAR STOP syst emname
L .J
simulates the IPL function when loading by device address.
is the virtual address (cuu) of the device that contains the
nucleus to be loaded.
is the cylinder containing the IPL data. If this operand is
specified, CP loads the IPL data from the specified virtual instead of from virtual cylinder zero. Virtual cylinder zero is the default when cylno is not specified.
This operand is valid only for virtual direct storage devices.
sets the virtual storage space to binary zeros before the
operating system is loaded. This operand is invalid if you a svstemname in the IPL command line.
allows the contents of your virtual storage space to remain
unchanqed prior to program load. This operand is invalid if you soecify a systemname in the IPt command line. NO:LEAR is
the default if you IPL by device (vaddr).
halts the virtual machine during the IPL procedure just before
the initial PSW is loaded. It provides the virtual simulation
of the IPL procedure for a real machine in instruction step mode. The STOP operand is invalid if systemname is specified
in the IPL command. When the virtual machine stops, you can
issue CP commands. For example, if you are loading OS or OS/VS into your virtual machine, you can use CP commands to store data into low storage, to load an alternate nucleus, or to
alter the apparent size of virtual storage. To restart the
virtual machine, issue the BEGIN command.
simulates the IPL function when loading a named system that
was previously saved via the SAVESYS command. It is loaded
into virtual storage and qiven control. For information about
saved systems, see the 88 VM/370 CP Command Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

INDICATE STORAGE-nnn% RATIO-nn.n is a measurement of the use of real storage. It is a
smoothed ratio of the sum of the estimated working sets
of the users in queue 1 and queue 2 (the runlist) to the
number of paqeable pages in the system, expressed as a
percentage. Because the criterion for allowing a user on
the eligible list to enter a queue is that at least 15
percent of his working set size must fit in the available
page frames, the value of STORAGE can be more than 100 percent.
indicates the scheduler contention ratio; RATIO is a
smoothed measure of the contention for real storage, and
is defined as RATIO=(E+M) 1M. M is the number of users in
queue 1 and queue 2 (the runlist), and E is the number of
users waiting to be allocated real storage by the
scheduler and, therefore, temporarily resident in the
scheduler's eligible lists. Thus, RATIO is the ratio of
active users to users being serviced, and is 1.0 for
optimum response. Optimum response occurs when enough
storage is available to accommodate all active users,
assuminq the processor can process their commands. If E
and M are both 0, the value of RATIa is set to 1.0. Values of FATIO=1.5 and M=10 mean that users are in the
eligible lists waiting for the scheduler to allocate real
storage to them, and that the full discrimination ability
of the biased scheduler may be exercisea upon them. PAGES: RES-nnnn WS-nnnn READS=nnnnnn WRITES=nnnnnn DISK-nnnn DRUM-nnnn VTIME=mmm:ss TTIME=mmm:ss SIO=nnnnnn RDR-nnnnnn PPT-nnnnnn PCH-nnnnnn
RES-nnnn WS-nnnn is the current number of your virtual storage pages
resident in main storage. This number is taken at an
instant of time during the execution of the INDICATE
command.
is the most recent system estimate of your working
set size.
READS=nnnnnn is the total number of page reads that have occurred
for you since you loqged on or since the last ACNT
command was issued for your virtual machine.
WRITFS=nnnnnn is the total number of pages written for you since you have logged on or since the last ACNT command was
issued for your virtual machine.
DISK-nnnn is the current number of virtual pages allocated for you on the system paging disk(s). This number is
taken at an instant of time during the execution of
the INDICATE command.
is the current number of virtual pages allocated for you on the system paging drum(s). This number is
taken at an instant of time during the execution of
the INDICATE coromand. 86 IBM CP Command Reference for General Users

INDICATE is your total virtual machine time since you logged
on or since the last ACNT command was issued for your
virtu al mach ine. TTTME=mmm:ss is your total virtual machine time plus total
processor time (virtual plus overhead) that you have
used lVU loqged on S1nce the last leNT command was issued for your virtual machine. SIO=nnnnnn is the total number of nonspooled I/O requests that
you have issued since you logged on or since the last ACNT command was issued for your virtual machine.
RDF-nnnnnn is the total number of virtual cards read since you loqged on or since the last ACNT command was issued
for your virtual machine.
PRT-nnnnnn PCfl-nnnnnn is the total number of virtual lines printed S1nCe you logged on or since the last ACNT command was
issued for your virtual machine.
is the total number of virtual cards punched since
you logged on or since the last ACNT command was
issued for your virtual machine.
Section 5. Format of CP Commands 87

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

Extracted Text (may have errors)

Extracted Text (may have errors)