STRSRVJOB (Start Service Job)

STRSRVJOB Command syntax diagram

 

Purpose

The Start Service Job (STRSRVJOB) command starts the remote service operation for a specified job (other than the job issuing the command) so that other service commands can be entered to service the specified job. Dump, debug, and trace commands can be run in that job until service operation ends. Service operation continues until the End Service Job (ENDSRVJOB) command is run.

The following commands can be used in the serviced job while remote service is being done:

Dump Job (DMPJOB)

Dump Job Internal (DMPJOBINT)

Dump Object (DMPOBJ)

Dump System Object (DMPSYSOBJ)

Start Debug (STRDBG)

Trace Internal (TRCINT)

Trace Job (TRCJOB)

Trace ICF (TRCICF)

 

Restrictions

• This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
• The issue of the command must be running under a user profile which is the same as the job user identity of the job being serviced, or which has use (*USE) authority to the job user identity of the job being serviced.

 

Required Parameters

JOB

Specifies the name of the job being serviced. If no job number is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, messages are sent to the user, and the user name and job number must be specified. The job name entered cannot be the name of the job issuing the command.

A job identifier is a qualified name with up to three elements. For example:

job-name
user-name/job-name
job-number/user-name/job-name

More information on this parameter is in Commonly used parameters.

job-name: Specify the name of the job being serviced.

user-name: Specify the name of the user of the job being serviced.

job-number: Specify the number of the job being serviced.

DUPJOBOPT

Specifies the action taken when duplicate jobs are found by this command.

*SELECT: The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, an escape message is issued.

*MSG: An escape message is issued when duplicate jobs are found.

Example for STRSRVJOB

STRSRVJOB  JOB(ABCD)

This command starts the remote service operation so that any trace, debug, or dump commands entered in this job are applied to the job named ABCD.

Error messages for STRSRVJOB

*ESCAPE Messages

CPF3501

Job is already being serviced, traced, or debugged.

CPF3520

Job not found.

CPF3524

More than one job with specified name found.

CPF3531

Job cannot be serviced.

CPF3536

Job completed and cannot be serviced.

CPF3549

Job &1/&2/&3 cannot be serviced.

CPF3676

Not authorized to service specified job.

CPF3909

Service command will not be processed.

CPF3918

Service request canceled.

CPF3938

Already servicing another job.