STRCPYSCN (Start Copy Screen)

STRCPYSCN Command syntax diagram

 

Purpose

The Start Copy Screen (STRCPYSCN) command allows the user to copy the displays of another display station to observe what is happening and diagnose problems.

If the STRCPYSCN command is used to copy displays from a source device that has the wide-display feature to an output device with a regular-width display, the command is accepted, but wide-display images are not shown and an informational message is sent to the target work station indicating that the display was not shown.

If the STRCPYSCN command is used to copy displays from a source device that supports graphic DBCS characters, the command is accepted and character information is shown, but graphic DBCS characters appear as single byte. No message is sent.

If the output device is not the requesting device, then the output device cannot be signed on. If the output device is signed on, a message is sent to the requester indicating that the device is not available for copying. If the source device is signed off after display copy has begun, the function automatically ends.

Note: The copy display function can be ended by either the source or target device.

 

Restrictions

  1. Permission must be given from the user of the source work station.

  2. When a request is made to begin display image copying, a break message is sent to the user of the source work station to inform the user that the displays are going to be copied. The user must reply to this message before any displays are copied.

  3. *REQUESTER is not valid for the SRCDEV or OUTDEV parameters when the command is submitted to batch.

 

Required Parameters

SRCDEV
Specifies the display station that is used as the source for the display images being copied.

*REQUESTER: The displays are copied from the display station that issued this command.

source-device-name: Specify the name of the display station name (other than the *REQUESTER) whose displays are being copied.

Note: If the display station specified for this parameter is a personal computer, it cannot be running PC organizer.

OUTDEV
Specifies the output device for the copying process.

*REQUESTER: The displays are copied to the work station from which this command is issued. If *REQUESTER is specified on the SRCDEV parameter, *REQUESTER cannot be specified on the OUTDEV parameter.

*NONE: The copied displays are not sent to a display station. If OUTDEV is *NONE, then OUTFILE must be specified.

display-device-name: Specify the name of the display station (other than the *REQUESTER) that shows the copied displays.

 

Optional Parameters

JOBQ
Specifies the job queue that is used to submit the job that shows the displays from the source device on the target device when the requesting device is not the target device. When OUTDEV(*REQUESTER) is specified, this parameter is ignored, since it defaults to the values for the target display station and then a submit job command is not necessary.

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.

The library list is used to locate the job queue.

QCTL: The default job queue, QCTL, is used.

job-queue-name: Specify the name of the job queue where the job of processing the copied displays is submitted.

OUTFILE
Specifies the qualified name of the database file where the copied displays are directed. If the database file does not exist, this command creates a database file in the specified library. Displays can be copied to a database file instead of, or in addition to, being shown on another work station, thereby keeping a record of the displays that were copied and shown.

Note: A library name of QTEMP cannot be used.

*NONE: The output is not directed to a database file.

The name of the database file 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.

file-name: Specify the name of the database file that receives the output of the display.

If the user qualifies the database file name with *LIBL, but the system cannot find the file, the file is created in the QGPL library. Or, if a library name is specified, the file is created in the specified library.

OUTMBR
Specifies the name of the database file member to which the output is directed.

Element 1: Member to Receive Output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter.

member-name: Specify the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.

Element 2: Operation to Perform on Member

*REPLACE: The system clears the existing member and adds the new records.

*ADD: The system adds the new records to the end of the existing records.

Example for STRCPYSCN 

STRCPYSCN  SRCDEV(WS2)  OUTDEV(*REQUESTER)

This command sends an inquiry message to the user of work station, WS2. The message indicates that the display station displays are about to be copied to another display station. If the user of that display does not wish this to happen, then a cancel (C) reply prevents the operation from beginning. To allow the operation to begin, the user responds with a go (G) to the message.

Error messages for STRCPYSCN

*ESCAPE Messages

CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF7AF4
Library QTEMP is not valid for OUTFILE keyword.
CPF7AF5
From device cannot be used with to device.
CPF7AF6
Device &1 not available.
CPF7AF7
Device name &1 not correct.
CPF9845
Error occurred while opening file &1.
CPF9860
Error occurred during output file processing.