STRDKTRDR (Start Diskette Reader)

STRDKTRDR Command syntax diagram

 

Purpose

The Start Diskette Reader (STRDKTRDR) command starts a spooled reader to the specified diskette device to read a batch input stream and place it on the appropriate job queue. This command specifies the name of the diskette device from which the input stream is read; the volume and data file that the input stream is on; and the names of the job queue and message queue to be used.

On a system job, more than one reader can be active at the same time (as determined by the spooled subsystem description). Each reader must have a unique reader name and have its own input device assigned to it. A reader that has been started can be actively reading input or waiting for device input. The reader can also be held or ended if the Hold Reader (HLDRDR) or End Reader (ENDRDR) command is used. The reader is ended at end-of-file.

Because each reader runs independent of the job that started it, users can continue doing other work on the system after they have started a reader. The reader is owned by the user who issues the STRDKTRDR command.

Restriction: This command cannot be used to read data files of diskettes that are in the save/restore format.

 

Required Parameters

DEV

Specifies the name of the diskette device that is used to read and enter an input stream into a job.

LABEL

Specifies the data file identifier of the file that is processed as an input stream. More information on this parameter is in Commonly used parameters.

 

Optional Parameters

RDR

Specifies the name of the spooled reader that is started. Each reader name must be unique.

*DEV: The name of the reader is the same as that of the diskette device specified in the DEV parameter.

reader-name: Specify the name by which the reader being started is identified.

VOL

Specifies one or more volume identifiers used by the file. More information on this parameter is in Commonly used parameters.

*NONE: No volume identifier is specified. Use the name of the current volume.

volume-identifier: Specify the identifiers of one or more volumes in the order that they are put on the device and read. Each identifier can have 6 alphanumeric characters or less. A blank is used as a separator character when listing multiple volumes.

CRTDATE

Specifies the creation date of the object.

Note:

The creation date should not be specified if the date is not checked against the diskette date by the system. If the date written on the diskette containing the data file does not match the date specified on this parameter, an error message is sent to the message queue specified on the MSGQ parameter.

*NONE: The creation date is not specified and no check is made.

creation-date: Specify the creation date of the data file that is read. The date should be in the format specified by the QDATFMT system value.

CODE

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character set code is used.

JOBQ

Specifies the job queue on which the job entries are placed. A job entry is placed on this queue for each job in the input stream that has JOBQ(*RDR) specified on the Batch Job (BCHJOB) command. If *RDR is not specified on the BCHJOB command, the job queue specified on the BCHJOB command or in the job description is used. (The job queue for each job in the input stream can be different.) This parameter is valid only if ACTION(*SUBMIT) is specified on this command, in the existing network job entry, or in a subsequent Change Network Job Entry (CHGNETJOBE) command.

Note:

If both the user identified in the job description of the job being read and the user processing the Start Diskette Reader (STRDKTRDR) command are not authorized to the job queue on which the job should be placed, the job ends and a diagnostic message is placed in the job log. The input stream, continues to be processed, starting with the next job. If either user is authorized to the job queue, the job runs without error.

The name of the job queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

QBATCH: The job entry is placed on the QBATCH job queue.

job-queue-name: Specify the name of the job queue to which each job read by this reader is sent if JOBQ(*RDR) is specified on its JOB command.

MSGQ

Specifies the qualified name of the message queue to which messages are sent.

*DEVD: The messages are sent to the message queue specified in the device description of the device named in the DEV parameter.

*REQUESTER: The messages are sent to the workstation message queue of the workstation of the user who started the process. If this value is specified for a batch job, *OUTQ is used.

The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

message-queue-name: Specify the name of the message queue to which the diskette reader messages created by the reader are sent.

Example for STRDKTRDR

STRDKTRDR  DEV(QDKT)  LABEL(OCT24)  VOL(SALES)

This command starts the spooled reader named QDKT, which reads diskette input from the device QDKT. Because *DEV was the default on the unspecified RDR parameter, the device name QDKT is also used as the reader name. The reader reads its input from the data file named OCT24 whose volume identifiers must be SALES. The default job queue QBATCH and the message queue QSYSOPR are used by the diskette reader.

Error messages for STRDKTRDR

*ESCAPE Messages

CPF1338

Errors occurred on SBMJOB command.

CPF2207

Not authorized to use object &1 in library &3 type *&2.

CPF3301

Reader &1 already started.

CPF3307

Job queue &1 in &2 not found.

CPF3330

Necessary resource not available.

CPF3347

Device &1 not found.

CPF3362

Objects in QTEMP not valid for parameter values.

CPF3363

Message queue &1 in library &2 not found.

CPF3367

Device &1 not diskette device.