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

CHASGE This is the response when you issue the CHANGE command. This is an indi=ation of the number of files changed. It does not reflect individual alterations to a given file. This message does not
appear if you have issued the CP SET IMSG OFF command line.
52 VM/370 CP Command Reference for General Users

CLOSE Use the CLOSE command to terminate the spooling activity on any virtual spoolej unit record or console device. The format of the :LOSE command
is:
PRINTER PRT PUNCH PCH vaddr HOLD NOHOLD r , I Reader r , I Ivaddr !HOld I I I !NOHoldl I L L .I .I r r , , ICONsole PUrge I I I Printer I I ) !PUnch r ,
r , I I Ivaddr IHOld I r DIst distcode] INAme {fn CftJ}' I I , I NOHoidl I dsname I I , L L L .I L J J J
closes all reader spool files.
closes your virtual machine's console spool file. Once a virtual console spool file is closed, it becomes a printer
spool file and can be manipulated in the same way as any
printer spool file (for example, it can be purged or changed).
closes all printer spool files.
closes all punch spool files.
is the virtual address (cuu) of the device to be closed. The address may represent a reader, console, printer, or punch.
makes the output spool file being closed unavailable for
further processing, until it is specifically requested or
changed. However, input reader files are still available for
processing (see Figure 7). This option, specified in the CLOSE command, overrides any previously specified HOLD or NOHOLD option for the files being closed.
makes the output spool file being closed available for further
processing, but the input reader file is no longer available
for nrocessing (see Figure 7). Specify NOHOLD if a HOLD established by the SPOOL command is still in effect and the
current active file is not to be held. Yoa can release one of your own output files in HOLD status by
using the CHANGE command. If an output file is spooled for
another user (SPOOL FOR userid), only the receiving virtual machine user can the file sta tus. If an output fil_e is
spooled to another user as an input file (SPOOL TO userid),
the HOLD option places the input file in HOLD status. The
file then cannot be read by the virtual machine until it is
changed to NOHOLD by the receiving virtual machine user.
section 5. Format of CP Commands 53

Previous Page Next Page

Extracted Text (may have errors)

CHASGE This is the response when you issue the CHANGE command. This is an indi=ation of the number of files changed. It does not reflect individual alterations to a given file. This message does not
appear if you have issued the CP SET IMSG OFF command line.
52 VM/370 CP Command Reference for General Users

CLOSE Use the CLOSE command to terminate the spooling activity on any virtual spoolej unit record or console device. The format of the :LOSE command
is:
PRINTER PRT PUNCH PCH vaddr HOLD NOHOLD r , I Reader r , I Ivaddr !HOld I I I !NOHoldl I L L .I .I r r , , ICONsole PUrge I I I Printer I I ) !PUnch r ,
r , I I Ivaddr IHOld I r DIst distcode] INAme {fn CftJ}' I I , I NOHoidl I dsname I I , L L L .I L J J J
closes all reader spool files.
closes your virtual machine's console spool file. Once a virtual console spool file is closed, it becomes a printer
spool file and can be manipulated in the same way as any
printer spool file (for example, it can be purged or changed).
closes all printer spool files.
closes all punch spool files.
is the virtual address (cuu) of the device to be closed. The address may represent a reader, console, printer, or punch.
makes the output spool file being closed unavailable for
further processing, until it is specifically requested or
changed. However, input reader files are still available for
processing (see Figure 7). This option, specified in the CLOSE command, overrides any previously specified HOLD or NOHOLD option for the files being closed.
makes the output spool file being closed available for further
processing, but the input reader file is no longer available
for nrocessing (see Figure 7). Specify NOHOLD if a HOLD established by the SPOOL command is still in effect and the
current active file is not to be held. Yoa can release one of your own output files in HOLD status by
using the CHANGE command. If an output file is spooled for
another user (SPOOL FOR userid), only the receiving virtual machine user can the file sta tus. If an output fil_e is
spooled to another user as an input file (SPOOL TO userid),
the HOLD option places the input file in HOLD status. The
file then cannot be read by the virtual machine until it is
changed to NOHOLD by the receiving virtual machine user.
section 5. Format of CP Commands 53

Help

CHANGE :OPY[*lnn specifies the number of copies of the file to be spooled to the virtual output device. The option is valid for printer
and punch files onlv. The value of nn (number of copies)
must be a number from 1 through 99. For nn less than 10, the leading zero is optional. The optional asterisk (*) can be
specified on print files to be spooled to the 3800 printer.
The asterisk (*) forces the 3800 printer to perform the file duplication internally one page at a time. This option avoids retransmission of the print file to the virtual output
device every time a copy is desired. HOLD prevents the file from being printed, punched, or read until
it is released. The file released when the CHANGE command
is issued with the NOHOLD operand specified. NOHOLD releases the specified file from user HOLD status. DIST dist
chanqes the distribution code specified in the VM/370 directory to the distcode specified on the command line, for
the specified file only. The distribution code appears on the output separators of the printer and punch output; it has
no effect on reader files. FL1\SH name nn MODIFY nane CHARS name FCB name
signifies that a forms overlay contained in the 3800 printer
be superimposed onto certain pages of the output. The name,
one to four characters, identifies the forms overlay to be used in the projection. The number nn can be anything from 0 to 99. The number specifies the first nn pages of output are
to be superimposed. The default, 0, indicates no
superimposing is desired. a copy modification module to be used when printing a
file on the 3800. This function makes it possible to alter
text bv either preventing printing of certain information or adding labels to output. The must be one to four If the name is omitted, the file prints normally
without modification.
specifies the character arrangement table used when printing
a file. The name must be from one to four characters; it
determines which writable character generation module (WCGM) is used for printing on the 3800.
controls the vertical spacing of output on a page. The name
must be from one to four characters. NAME in fft 1 NAME dsna:ne assians identification to the spool file in the CMS format
filename and filetype. The field, fn, is a one-to
eight-character alphameric filename assigned to the file for
identification. The field, ft, is a one-to eight-character
alphameric filetype assigned to the file for identification.
If ft is not specified, the filetype is set to blanks.
assigns identification to the spool file in a non-eMS format.
The field, dsname, is a 1-to 24-character field suitable for
specifying as or DOS files (for example, SYS1.SYSLIB.MYMAC). 50 IBM VM/370 CP Command Reference for General Users

CHANGE
1. Issue the QnERY command to determine the current attributes of the
file.
2. In order to chanqe an output file, the file must have been closed blt not selected for printing or punching.
3. An input (READER) file can be changed at any time before it is openea, that is, before the first read is issued for the file. Use the QUERY command to verify the new attributes of the file or
files. If the spoolid operand is used and if more than one spool file with that number exists, then only the first spool file encountered is
chanqed.
6. Uniqle to spool class X is a special line of text that can be printed on the separator page and at the top of each page of
printer output. The default line internal to the system's program is a line of blanks. If you wish to use this spool class X facility, ask your system programmer to modify the text to your
requirements.
7. In order to print on the 3800, the name the user specifies in the FLASH option must match the FLASH name the VM/370 operator
specifies in the START command, unless the FLASH number nn is o. If the number is 0 or the FLASH option is omitted, a file still
prints on the 3800 as long as the spool file class matches the
print class desiqnated by the installation for the 3800. If a user
fails to meet these requirements, the spool file is submitted to
another printer and the special 3800 print options are ignored.
8. When a spool file containing special 3800 options is spooled to a
printer other than the 3800, the options are ignored and printing occurs normally.
9. An FCB name of 6, 8, or 12 avoids an FCB forms mismatch. These
special FC3 specifications print the entire spool file at 6, 8, or
12 lines per inch regardless of the paper size. VM/370 calculates
the proper FCB form to load. 10. When the 3800 printer is activated, the operator specifies the
character arranqement table and the FCB value that prints the separator page for every output file. If a user omits the CHARS option on a file spooled to the 3800, the printing defaults to the character arranqement table previously defined by the operator.
This is also the case for the FCB option.
11. issues a message to the user whenever a file spooled to the 3800 printer contains invalid or undefined option names. If the operator has not automatically purged the file, the user can correct the situation via the CHANGE command or spool the file to
another printer.
{
nnnn} FILES NO section 5. Format of CP Commands 51

Previous Page Next Page

CLOSE PUR3E If input file is closed with the HOLD option, the file is
saved and not purged from the system. The saved file is avai13ble for virtual machine and user processing and is not
placed in a user hold status. Input spool files that are
closed are normally purged from the virtual machine.
closes and immediately purges from the virtual machine the
output spool files. No output file is produced. DIST distcode
uses the one-to eight-character alphameric identification
(distcode) on the output separators of printer and punch
instead of the identification specified in the VM/310 directory. The distribution code is changed for this file
only and does not affect other files or change the VM/310 directory. If the file is spooled to another user, this
option has no effect. NTiME fn [ftl
assigns identification to the spool file in the eMS format
filename and filetype. The filename, fn, is a one-to
eiqht-character alphameric name assigned to the file for
identification. The filetype, ft, is a one-to
eight-character alphameric type assigned to the file for
identification. If ft is not the filetype is set
to blanks. NTiME dsnalte assiqns identification to the spool file in a non-CMS format.
The dsname field is a 1-to 24-character field suitable for OS or DOS files (for example, SYS1.SYSLIB.MYMAC). Only 20 characters of the 24-character dsname are displayed by QUERY, even though a name of up to 24 characters is valid. 1. If the file is an input reader file, the file being processed is plrged unless SPOOL READER HOLD was previously specified (see the The effect of HOLD or NOHOLD for a particular file
established by the SPOOL command can be overridden by specifying NOH-OLD or HOLD, respectively, in the CLOSE command.
2. If an input spool file is read but the read is not completed (that
is, the virtual machine does not get a last-card indication), you
must issue a CLOSE READER command in order to be able to read that
file (or to read any other file). Unless you specify HOLD when you close a reader file, the file is purged.
3. If the file is an output file on a printer, punch, or console, the
file is either queued for output on a real unit record device, or,
if the virtual output device is transferred (by use of the "SPOOL TO userid" command), the file is queued for input to the
receivinq user.
4. You can specify distcibution code
its contents.
a filename and filetype and an
to aid in later identification of the IBM LP Command Reference for General Users optional
file and

r CLOSE s. FiguLe 7 shows what happens to an input file in your virtual reader
when the CLOSE command is issued with the HOLD or NJHOLD operand in
effect. The CLOSE command can result in an input file being purged
or s3.ved. (CLOSE Command Settinq) Norm3.l EOF In /:) oF:::I" 1 ... \ ....... _.-\,4 ...... '- CLOSE) CLOSE CLOSE HOLD CLOSE NOHOLD SPOOL Command Options Set for a virtual Input Device NOHOLD File purged
File purged
File saved
File purged HOLD File saved
File saved
File saved I I ----------------------------1
File purged I ----------------------1 INote: The term "saved" means that the file is neither purged
lin HOLD st3.tus. A subsequent READ could read this file.
nor is itl I L ____ J
Figure 7. Action on CLOSE for a Virtual Input Device.
r I I 6. FiguLe 8 shows what happens to a file in your virtual output device
when the CLOSE command is issued with the HOLD, NOHaLD, CONT, and NOCONT operands in effect. SPOOL Command Options Set for a Virtual Output Device
1 (C LOSE Command
sett inq) NOHOLD NOCO}!T HOLD NOCONT NOHOLD HOLD CONT CONT CLOSE CLOSE HOLD IFile released I File held Ifor processinql IFile held I File held
iNo I I No
action
1
iNo action
1 I ac tion 1 INo action
1 CLOSE NOHOLD IFile released IFile released INo action
1 INo action
1
lfor processinglfor processinql I 1 INc is taken until you issue a SPOOL {PRTIPUN} NOCONT command. I Then vou can issue a CLOSE command to release the file for I processinq.
L
Fiqure 8. Taken on CLOSE for a Virtual Output Device Section 5. Format of CP Commands 55

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