9. PROCESSING › 9.1 Operations › 9.1.2 Automatic Operation › 9.1.2.1 VMTWAITR Commands
9.1.2.1 VMTWAITR Commands
VMTWAITR accepts and processes commands that arrive as the
message text with the CP SMSG command. A VMTWAITR command
consists of a command name followed by one or more positional
operands. One or more blanks must separate each entry in the
command line unless otherwise indicated.
NOTATIONAL CONVENTIONS
In the command formats shown below, uppercase letters
represent the shortest version of the command that you can
enter. Lowercase letters and words that appear in the
command format box represent variables for which specific
information should be substituted. Uppercase letters and
words and the symbols other than those described below should
be entered as specified in the format box.
The following symbols are used to define the command format
and should never be typed when the actual command is entered:
< > -- denotes options that may be specified or omitted.
| -- denotes choices, one of which MUST be selected.
+ +
| | -- denotes choices, one of which MAY be selected.
+ +
... -- denotes that the preceding item or group of items may
be coded more than once in succession.
TRANSFER Initiate the Data Transmission
When to Use TRANSFER
Use the TRANSFER command to start transmitting data.
TRANSFER Format
+-----------------------------------------------------------+
| + + |
| TRAnsfer datatype | <fn ft> < ( option > | |
| | | |
| | <fn ft <fm>> ( NOLINK | |
| + + |
| |
| option: FROM userid cuu <PASSWORD readpass> |
+-----------------------------------------------------------+
Operands
datatype
indicates the type of data to be transmitted. Valid
values are:
ACCOUNT - initiates the VM Account data transfer
function
CAVMACT - initiates the CA VM:Account data transfer
function
MONXA - initiates the VM/ESA and z/VM Monitor data
transfer function
NETDATA - initiates the VM Network data transfer
function
POWER - initiates the VSE/POWER Account data transfer
function
ERDS - initiates the Error Recording data transfer
function
fn ft
is the file identifier of input data to be transferred.
The VM Data Transfer Program locates this file from the
minidisk that has been defined on the corresponding data
parameter menu. If you use the optional FROM statement,
the minidisk address and the owner userid you specify
are used to search the file.
The INPUT DISK FILE MODE parameter on the Common
Transfer Parameters menu determines the file mode with
which the VM Data Transfer Program accesses the data
disk.
fn ft <fm> ( NOLINK
specifies the file identifier of input data to be
transferred. Access to this file does not require the
VM Data Transfer Program to locate the data disk prior
to its transmission. When fm is omitted, the file mode
A is assumed. If fm is specified as an asterisk (*),
all accessed disks are searched for the file.
FROM userid cuu <PASSWORD readpass>
indicates where the VM Data Transfer Program locates the
input data file. The userid is the user identifier
whose system entry contains the data disk, and cuu is
the virtual address of the data disk as defined in the
specified userid's entry in the system directory.
The PASSWORD readpass is the read access password of the
data disk. The readpass is a one to eight character
string that must be the read access password of the
specified data disk as defined in the system directory
for the userid that you specified above. This operand
must be omitted if no password is defined.
Corequisites
If you use the TRAnsfer command, you must code the
following in VMTFDEF:
datatype.INPUT section:
ec = INPUTDEF(dtype,signal,suffix)
exit ec
datatype.TERMINATE section:
ec = Cleanup(dtype,info)
exit ec
where datatype is one of the data types listed above.
See Section 10.2.1 for instructions on modifying
VMTFDEF.
Usage Notes
1. The TRANSFER command triggers VMTXMIT to transmit
data. VMTXMIT examines the type of transfer
function, then calls the corresponding input exit at
VMTFDEF for input data allocation. It passes the
operands of the TRANSFER command to VMTFDEF, whose
INPUTDEF routine builds the data definition for the
INPUT DDname. At the end of the transfer process,
VMTFDEF is called again for resource deallocation,
which is performed by the CLEANUP routine.
2. Use the TRANSFER command to transmit data immediately
after it is cut.
To delay data transfer, use the INPUTDD command to
define the data source after it has been created.
Then, at a prescheduled time, issue the TRANSFER
command without input file entry, thereby starting
the transmission for the data source defined by the
INPUTDD command.
3. The file mode used to access a data disk is
determined by the INPUT DISK FILE MODE parameter on
the Common Transfer Parameters menu. The INPUT DISK
FILE MODE is used to access the data disk if it is a
letter within A and Z. If the INPUT DISK FILE MODE
is coded with an asterisk (*), the VM Data Transfer
Program will find an unused file mode letter to
access the disk.
4. You cannot use the TRANSFER command to define an OS
data set or a VSE file that has more than two
qualifiers in its name. Instead, use the INPUTDD
command's DSN qual1... form to build the data
definition for the input. Then use the TRANSFER
command without a file identifier to start the
transmission.
