TSO SMSG command—Monitoring the Status of LPD

Purpose

The TSO SMSG command provides an interactive interface to the LPD server to:

Turn on and off diagnostics tracing
Query the work queue currently being used by LPD server

These commands are privileged so the commands are accepted only from users specified in the OBEY statement in the LPD server configuration data set. For more information regarding this statement, see the z/OS Communications Server: IP Configuration Reference. Responses to the SMSG commands are sent to the SYSPRINT file that is associated with the LPD started procedure job.

Note: The TSO SMSG LPD command uses the Pascal socket API, so VMCF must be started for the command to be successful. If VMCF is not active, the following message is issued to the terminal of the TSO user: EZY2040I SMSG: VMCF is not active on the system.

Format


>>-SMSG--lpd_jobname--+-TRACE--+-ON--+-+-----------------------><
                      |        '-OFF-' |   
                      '-PRINT WORK-----'

Parameters

TRACE ON: Enables tracing in the LPD server.
TRACE OFF: Disables tracing in the LPD server.
PRINT WORK: Prints the jobs in the work queue for LPD.

Examples

The following example shows the output from the SMSG LPD PRINT WORK command, which is sent to the SYSPRINT file.

Note: Response to the SMSG LPD command does not display on the screen for the user. The user must look in the SYSPRINT file that is associated with the LPD job to view the response.

16:59:29 EZB0786I Command received "PRINT WORK".  
16:59:29 EZB0731I       Work Queue start    
16:59:29 EZB0732I               <job number>    <job state>         
16:59:29 EZB0733I       Work Queue end