HP 3000 Manuals HP 3000 Manuals
DATA
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:
STREAM DATAFL
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:
FILE DATAFL;DEV=JOBTAPE
To run the program that requires the data, enter:
RUN PROGY
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