Troubleshooting receiving RJE jobs from the host

If you have followed the Getting started with RJE configuration steps, you have already configured the host and the software to receive jobs from the host to RJE. At this point, jobs from the host will automatically be released from the host and appear in the Spool Window.

If jobs from the host are not being sent to the Spool Window, then check the following.

See also:


Checking that you are connected to the host

Jobs will not be received unless there is a connection with the host. Complete the following steps to make sure you are connected to the host.

  1. Open the RJE Console.

  2. Check that the Status is shown as Logged on. If the Status is not shown as Logged on, then you are not connected to the host. Follow the procedures in the Connecting to the host topic.

Checking the printer settings

Here is a typical response from JES2 after issuing the $DU, PR1 command.

$DU,PR1

 

 

 

$HASP603 R122.PR1

 

 

$HASP603 R122.PR1

STATUS=INACTIVE,ASIS=NO,CCTL=YES,CKPTLINE=0,

 

$HASP603

CKPTPAGE=10,CMPCT=YES,COMPRESS=YES,

 

$HASP603

COMPACT=COMPACT1,CREATOR=,DEVFCB=,EJECT=YES,

 

$HASP603

FCB=8(STD),FCBLOAD=YES,FORMS=STD,JOBNAME=,

 

$HASP603

LIMIT=(0,*),LRECL=132,PRMODE=(LINE),

 

$HASP603

PRWIDTH=132,QUEUE=AJ,RANGE=(J1,32767),

 

$HASP603

ROUTECDE=(R122),SELECT=PRINT1,SEP=YES,

 

$HASP603

SEPDS=NO,SETUP=HALT,SPACE=,SUSPEND=YES,

 

$HASP603

TRACE=NO,TRANS=DEFAULT,UCS=0(STD),

 

$HASP603

VOLUME=(,,,),WRITER=,

 

$HASP603

WS=(W,Q,R,PRM,LIM,F,FCB,UCS/)

The most important information in the listing above is underlined, although the other parameters can also be important in some cases. The first important parameter is the STATUS, which can have several values as described in the following table.

Value

Description

STATUS=DRAINED

Printer has been halted, $S PR1 required to start it again.

STATUS=INACTIVE

Printer is started and ready, but no jobs are currently printing.

STATUS=ACTIVE

A job is currently printing.

The next two underlined parameters are the FORMS and QUEUE parameters. These show the current setting for form and class (QUEUE represents class). This is similar to the form and class setting on the printer line in the Spool Window. In this example, the form is STD and classes allowed are A and J.

The final key parameter is WS, which is the work selection criteria. This is a list of criteria that will influence which jobs will be allowed to print on this printer, what order they will print in, and a few other details. Because Q and F are both listed in the example, then both class and form will be used as criterion in deciding which print jobs will go to this printer. You can remove a criterion from the list with the command $T PR1, WS=(-criteria). For example, use $T PR1, WS=(-F) to remove FORMS from the work selection. That means a job does not have to have the same form type as the printer in order to print. In other words, all forms can print without the operator having to send a change form command to JES Acronym for Job Entry Subsystems of the IBM MVS operating system. These subsystems are used for entering jobs into the MVS operating system and dispensing the output from the jobs.

Checking that there are jobs

The next thing you can do is find out if there is output waiting in the JES queue for this remote. Unfortunately this is not always possible from the remote, but usually you can retrieve the necessary information by issuing the Display forms queue ($DF) command.

The Display forms queue ($DF) command is the most reliable way to find out if output is waiting in the JES queue for this remote. It results in a list of the different forms (and classes) associated with any jobs waiting to print on this remote.

$DF

 

 

 

 

 

$HASP621 OUT R=R122

 

 

 

 

$HASP621 OUT R=R122

 

   F=CTST

C=**** T=**** W= (NONE)

 

$HASP621 PRMODE=LINE

CLASS

A=2      B=1

 

 

$HASP621 OUT R=R122

 

 

 

 

$HASP621 OUT R=R122

 

   F=STD

C=**** T=**** W= (NONE)

 

$HASP621 PRMODE=LINE

CLASS

A=3

 

In the example above, there are six jobs waiting, three of form CTST (two of those are class A and one is class B) and three of form STD (all three are class A). This display is intended to tell the operator which forms are waiting so they can load the appropriate paper and then release the jobs with that form (and class). To release the jobs with the CTST form, you can set the printer for this form and the two different classes using the command $T PR1, F=CTST, Q=AB.

If there are no jobs waiting, then JES will return the message NO OUTPUT QUEUED.

Another way to view jobs is to use the Display jobs ($DJ) command. The $DJ1-32767 command displays the status of any jobs submitted from this remote, no matter what destination the output is bound for. The following is a sample of the JES2 response to the command.

$DJ1-32767

 

         $HASP610 JOB(S) NOT FOUND

 

 

 

$DJ1-32767

 

JOB16250 $HASP608 CCTEST   AWAITING HARDCOPY

PRIO  1 ANY

JOB16252 $HASP608 NF       AWAITING HARDCOPY

PRIO  1 ANY

Matching the printer criteria to the job criteria

You might see jobs waiting, but the jobs are not printing. This usually occurs when the job's criteria (that is, form and class) do not match the criteria on the printer.

To find out more detail about a specific job, use the$LJnnnnn,ALL command. In this example we use the job number 16250.

$LJ16250,ALL

JOB16250

$HASP686

OUTPUT(CCTEST)

 

JOB16250

$HASP686

OUTPUT(CCTEST)

OUTGRP=2.1.1,BURST=NO,FCB=****,

 

$HASP686

 

FLASH=****,FORMS=CTST,HOLD=(NONE),

 

$HASP686

 

HOLDRC=,OUTDISP=WRITE,PAGES=,

 

$HASP686

 

PRIORITY=12,PRMODE=LINE,QUEUE=A,

 

$HASP686

 

RECORDS=(15 OF 15),ROUTECDE=R122,

 

$HASP686

 

SECLABEL=,TSOAVAIL=NO,UCS=****,

 

$HASP686

 

USERID=BARRGAT,WRITER=

JOB16250

$HASP686

OUTPUT(CCTEST)

 

JOB16250

$HASP686

OUTPUT(CCTEST)

OUTGRP=1.1.1,BURST=NO,FCB=****,

 

$HASP686

 

FLASH=****,FORMS=STD,HOLD=(NONE),

 

$HASP686

 

HOLDRC=,OUTDISP=WRITE,PAGES=,

 

$HASP686

 

PRIORITY=11,PRMODE=LINE,QUEUE=A,

 

$HASP686

 

RECORDS=(68 OF 68),ROUTECDE=R122,

 

$HASP686

 

SECLABEL=,TSOAVAIL=NO,UCS=****,

 

$HASP686

 

USERID=BARRGAT,WRITER=

As the resulting messages show, the CCTEST job actually contains two outputs, one having FORMS=CTST and class of QUEUE=A, the other having FORMS=STD and class of QUEUE=A. You can also tell from this listing if the job has been put on hold.

Use the $T PRn, x=x (change printer) command to change the status or criteria of the printer in JES to match the criteria of the waiting jobs. The following table lists several useful examples.

Command

Description

$T PR1, F=STD

Change the form on PR1 to STD.

$T PR2, Q=ACDJS

Set the list of classes to be printed by PR2 to A, C, D, J, and S.

$T PR3, F=STD, Q=ACDJS

Combine previous two commands, but on PR3.

$T PR1, WS=(-F)

Remove forms from the Work Selection of PR1.

$T PR1, WS=(F)

Add forms to the Work Selection of PR1 (before the slash).

$T PR1, WS=(/F)

Add forms to the Work Selection of PR1 (after the slash).

$T RMT15, MFORM=J

Reformats host messages so they wrap properly in the RJE Console when viewing.