Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Copy Screen (STRCPYSCN) command allows you to copy the screens of another display station on your 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 the target device.
Restrictions:
Top |
Keyword | Description | Choices | Notes |
---|---|---|---|
SRCDEV | Source device | Name, *REQUESTER | Required, Positional 1 |
OUTDEV | Output device | Name, *REQUESTER, *NONE | Required, Positional 2 |
JOBQ | Job queue | Qualified object name | Optional |
Qualifier 1: Job queue | Name, QCTL | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
OUTFILE | File to receive output | Single values: *NONE Other values: Qualified object name |
Optional |
Qualifier 1: File to receive output | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
OUTMBR | Output member options | Element list | Optional |
Element 1: Member to receive output | Name, *FIRST | ||
Element 2: Replace or add records | *REPLACE, *ADD |
Top |
Specifies the display station that is used as the source for the screen images to be copied.
This is a required parameter.
Top |
Specifies the output device for the copying process.
This is a required parameter.
Top |
Specifies the job queue used to submit the job which shows the screens from the source device on the target device when the requesting device is not the target device. When *REQUESTER is specified on the Output device (OUTDEV) parameter, this parameter is ignored, since it defaults to the values for the target display station and then a submit job is not necessary.
Qualifier 1: Job queue
Qualifier 2: Library
Top |
Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
Qualifier 1: File to receive output
Qualifier 2: Library
Note: If a new file is created, system file QASCCPY in system library QSYS with a format name of QSCCPY1 is used as a model.
Top |
Specifies the name of the database file member that receives the output of the command.
Element 1: Member to receive output
Element 2: Replace or add records
Top |
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) reply to the message.
Top |
*ESCAPE Messages
*NOTIFY Messages
Top |