 |
» |
|
|
|
Enters data into the system from a device file. (Cannot be
used to enter data from $STDIN.)
(Native Mode) Syntax | |
DATA [jsname,] username [/userpass] .acctname [/acctpass] [;filename] Parameters | |
- jsname
Name of job or session that is to read data. Default
is no job/session name. It may contain up to eight alphanumeric
characters, beginning with a letter. - username
User name that allows you to access MPE/iX in this
account, as established by the account manager. It may contain up
to eight alphanumeric characters, beginning with a letter. - userpass
User password, optionally assigned by the account
manager. It may contain up to eight alphanumeric characters, beginning
with a letter. If a password exists, but is not supplied in the
command syntax, the STREAM
command will prompt you for it if: The STREAM
command is invoked from a session. Neither $STDIN nor $STDLIST is redirected. The DATA
command is a first level data command (it is not nested within a
second level STREAM
command).
- acctname
Account name under which job/session is running,
as established by the system manager. It may contain up to eight
alphanumeric characters, beginning with a letter. - acctpass
Account password, optionally assigned by system
manager. It may contain up to eight alphanumeric characters, beginning
with a letter. If a password exists, but is not supplied in the
command syntax, the STREAM
command will prompt you for it if: The STREAM
command is invoked from a session. Neither $STDIN nor $STDLIST is redirected. The DATA
command is a first level data command (it is not nested within a
second level STREAM
command).
- filename
Optional name for the data, used to distinguish
between two separate data files that are to be read by the same
program. It may contain up to eight alphanumeric characters, beginning
with a letter. Default is that no distinguishing name is assigned.
Operation Notes | |
This command identifies data to be read from a device file
other than your standard job/session input device. It can be used,
for example, to input a data file from a spooled input device for
later use by an interactive session or a batch job. The DATA
command is the only command that can be entered before a job or
session is initiated. Files identified by DATA
may be input only from magnetic tape on spooled tape drives or with
the STREAM command. To designate a set of data as an auxiliary file for your job
or session, enter the DATA
command followed by the set of data and the EOD
command. To access the data, begin your job or session using the
same identity ([jsname,]username.acctname)
used in the DATA
command. If the filename parameter is
omitted, several data files can be read from any job or session
with the same identity. When entered from magnetic tape, such data must reside in
a file on a single tape volume, and the blocking factor must be
1. When the media containing the data file is placed on the tape
drive and that device is placed online, MPE/iX reads the entire
file. At that point, the job can access the data, which remains
available until it is actually read. To submit data from a disk
file, you must use the STREAM
command. The time-related parameters of the STREAM
command may not be used when STREAM
is used with the DATA
command. The STREAM
command will prompt you for both user and account passwords if they
exist and are not supplied in the DATA
command if the following conditions are met: The STREAM
command is invoked from a session. Neither $STDIN nor $STDLIST is redirected. The DATA
command is a first level data command (it is not nested within a
second level STREAM
command).
Use | |
This command may be issued from a session or job. Use the
STREAM command
to input a data file. This command cannot be used directly from
$STDIN or from
a program. Examples | |
A data file is created on disk, and the STREAM
command is used to make the file available to your program. To create the file DATAFL
on disk, invoke a text editor (like EDITOR)
and enter the data beginning with the DATA
command and ending with the EOD
command. For example: EDITOR
/ADD
DATA SESSB,BROWN.ACCT1
.
.
.
EOD
//
/KEEP DATAFL,UNN
/EXIT |
To stream the data file using the STREAM
command, enter: To log on to a session, using precisely the same identity
that was used in the DATA
command, enter: MPE XL:HELLO SESSB,BROWN.ACCT1 |
To enter a FILE
command equating the formal file designator (used by the program)
with the stream device (identified by the device class name JOBTAPE),
enter: To run the program that requires the data, enter: Once the data has been read, it is no longer available to
the system. If another program requires this data, the data must
be entered again with the STREAM
command. Related Information | |
- Commands
EOD,
STREAM - Manuals
None
|
