SPOOL Once a snool file by issuing the CMS PRINT or PUNCH command or
the CP CLJSE CP assigns the spool file a number between 1 and 9900. Thi3 is called the spoolid (spool file identification) for the file. It can be used as a convenient way to identify the file. It
can also be used when you are manipulating the file with VM/370 spooling
commands as ORDER, CHANGE or CLOSE. are assiqned to all your spool files sequentially. When the maximum nlmber (9900) is assiqned, CP begins again with the number 1. When print or punch a file, CP displays at your terminal the spooli1 it assianed to your file if (1) multiple copies of the file are
beina orocessed, (2) the file is being transferred to another user, or
(3) the file is placed in a user hold status. You can find out various
kinds information about a file using the spoolid with the many forms
of the QUERY command.
spool files can be transferred between users via the SPOOL and TRANSFER commands. transfer printer or punch files of your virtual machine to
the virtual Leader of some other user, issue the SPOOL command with the TO option:
spool device to userid where 1evice is the virtual device type or virtual address (for example,
PRINTER, DUNCH, OOE) and userid is the name of the designated user's
reader.
If yOJ only want to print or punch a file for someone else, you can
issue the SPOOL command with the FOR option:
spool device for userid
where is the same as the previous example.
the distribution code for the designated user.
The userid provides To transfer printer
another user's reader,
or punch files from your virtual card reader to
issue the TRANSFER command with the TO option:
transfer option to userid where option is SPOOLID, CLASS, or ALL and userid is the designated
user's virtual reader.
If vou merelv wish to reclaim a transferred file, you can issue the same with the FROM option:
transfer option from userid
where option and userid are the same as the previous example.
1. Files that have been spooled for another user are not in that
user's virtual reader and, therefore, you cannot reclaim them.
2. transfer any file that is queued on your virtual readers; however, vou can reclaim only those files which you originated. Section 5. Format of CP Commands 147

SPOOL direct files to remote stations, use the CP TAG and SPOOL commands in with a command that causes the file to be closed and sent to
a virtual device (for example, a virtual printer or punch). Use the TAG
command specify the device to be spooled and to associate with that
device the location identifier (locid) for the destination of the file:
tag dev device locid
where device is the virtual device type (for example, PRINTER or PUNCH) or virtual device address (vaddr) and locid is the name of the to which the file is to be transmitted. Use the SPOOL command to specify that output to the device specified
in the command is to be sent to the RSCS virtual machine, which performs
the actual transmission of the file:
soool device to userid
where 1evice is the same virtual device type or virtual device address
specified in the TAG command and userid is the userid of the RSCS virtual michine at your installation. You can find out the userid of
your installation's RSCS virtual machine and the locid for the various
remote stations from your installations's system programmer.
After you issue the TAG and SPOOL commands, use a command (such as
the CMS PRINT or PUNCH command or the CP CLOSE command) to cause the
spool file to be generated, closed, and spooled to the specified virtual
device. Once y)U have closed a spool file that is spooled to another user,
you cannot change or query the spool file tag. If the file has not been
selected for processing by the RSCS virtual machine, you can use the command to get the file back to your virtual reader. When changes are necessary, you can issue the TAG QUERY DEVor FILE command
to determine the TAG information associated with a given virtual device
or file. You can then use the FILE operand of the TAG command to
chanqe a tag that was previously set.
The example shows how to use these three commands to
transmit a CMS file to a remote location:
taq 1ev punch cambridg
spool punch to net
punch myproq assemble
The TAG command defines the type of file to be transmitted, a punch
file, and the remote station to which you want it transmitted, CAMBRIDG. NET is the userid of the virtual machine controlling the RSCS network:
you direct y)ur file to that virtual machine with the SPOOL command.
The PUNCH causes the file MYPROG ASSEMBLE to be punched on your
virtual michine card punch, closed, and then spooled to the virtual
reader of the RSCS virtual machine, which you specified in the SPOOL command. The RSCS virtual machine then processes your file (now a VM/370 SP)ol file) and 'transmits it across the RSCS network.