>>-+--------+--$$POST--+-TYPE=--+-type-char--+-+---------------->
   '-symbol-'          |        '-(--R--x--)-' |   
                       '-ELMT=--+-addrx----+---'   
                                '-(--R1--)-'       

>--+-----------------------+--+--------------------+------------>
   |            .-SVC----. |  '-,ERRET=-label-R--x-'   
   '-,LINKAGE=--+-BRANCH-+-'                           
                '-SYSTEM-'                             

>--+--------------------+--------------------------------------><
   '-,OKRET= label-R--x-'   

TYPE=

Specifies the resource that is to be posted. You can specify the resource characters (which appear below) or you can specify register notation (R2-R12). If you specify register notation, the register must contain a resource number (0 through 63).

If you specify resource characters, you must specify one of the following:

ABIT

Waiting for the next dispatcher cycle

ALICE

PCE waiting for warm start to complete

ALOC

A dynamic allocation has completed

ARMS

Automatic restart manager support services

BUF

A JES2 buffer has been released

CCAN

Cancel JOB/TSU/STC in conversion

CKPT

A JES2 checkpoint write has completed

CKPTL

Looking for a CKPT read

CKPTP

A checkpoint cycle has completed

CKPTW

A JES2 checkpoint should be written

CMB

A console message buffer has been released

CNVT

A converter has been released

DAWN

Post PCEs waiting for work notifications

DILBERT

PCEs waiting for $DILBERT requests

EOM

Post PCEs waiting for End Of Memory events

FSS

A functional subsystem has completed FSS-level processing

GENL

Provides a method of communication from one processor control element (PCE) to another. It does not provide serialization between the PCEs. You must ensure the condition of the waiting PCE is satisfied before it is posted. Frequent use of the GENL resource name will have a severe impact on your installation's performance.

HOMOG

PCEs waiting for JESplex version change

HOPE

An output processor has been released

IMAGE

A UCS or FCB image has been loaded

IRCLEAN

Internal reader cleanup needed

JCMD

A JES2 job queue element has been marked for cancel ($C) or restart ($E) processing

JOB

A JES2 job queue element has changed status

JOE

A JOE has been released

JOT

A JES2 job output element has changed status

LOCK

A lock has been released

MAIN

Storage is available

MFMT

PCEs waiting for SPOOL mini-format conversion

NRM

PCEs checking the availability of NJE devices and initiating their starts appropriately.

PCETM

Waiting for resource manager to detach PCE

PSO

A process SYSOUT request has been queued for the JES2 PSO processors

PURGE

A JES2 job queue element (JQE) has been placed on the purge queue

PURGS

Purge resources from $PURGER have been released

RMWT

Waiting for resource manager to finish processing

RSV

A JES2 RESERVE has been satisfied

SPI

PCEs waiting for SYSOUT API (SAPI) requests

SPIN

A spin data set has been created

SMF

AN SMF buffer has been released

TRACK

A track group from the JES2 spooling data set has been released

UNIT

A device control table has been released

WARM

Warm processor is waiting for work

XMITJOB

A JES2 job queue element (JQE) has been placed on the $XMIT queue to be transmitted to another node.

value

An installation-defined dispatcher resource name or number

ELMT=

Specifies the address of the element where the event indicator is to be set. Symbolic names for these indicator elements are as follows:

• CCTASYNC – Post asynchronous I/O processor
• CCTCKPTP – Post checkpoint processor
• CCTCOMM – Post command processor
• CCTENFP – Post ENF listen processor
• CCTJOB – Post execution processor
• CCTJQRP – Post JQE request processor
• CCTMLLM – Post line manager
• CCTOFFM – Post SPOOL offload processor
• CCTRCP – Post remote console processor
• CCTSPOOL – Post spool manager
• CCTSSPCE – Post SJF services processor
• CCTTIMER – Post timer processor
• CCTTRPCE – Post trace logger
• CCTXSTIM – Post time excession processor

The corresponding processor control elements are posted by the JES2 dispatcher on recognizing the post elements line in $$POST.

If you use register notation, the designated register must be loaded with the address of the element before executing this macro. Do not use register 2 for this address.

ERRET=

Specifies a label to be branched to or a register to be branched on if JES2 returns a non-zero return code in R15. This parameter is optional.

OKRET=

Specifies a label to be branched to or a register to be branched on if JES2 returns a zero return code in R15. This parameter is optional.

LINKAGE=SVC|BRANCH|SYSTEM

Specifies the type of linkage JES2 is to use when it issues the MVS POST macro instruction. The requirements for specifying each type of linkage depend on from which address space the $$POST is issued.

When the $$POST is issued from the JES2 address space:

Linkage Type

Requirements

BRANCH

The $$POST caller must be in primary ASC mode and must hold the local lock.

SVC

None

SYSTEM

The $$POST caller must not hold any locks.

When the $$POST is issued from a non-JES2 address space:

Linkage Type

Requirements

BRANCH

If the $$POST caller holds the local lock, the caller must be in the home address space. If the $$POST caller does not hold the local lock, the caller can be in any address space.

SVC

The $$POST caller must be in task mode and in primary ASC mode.

SYSTEM

The $$POST caller must be enabled, unlocked, and in primary ASC mode.

Note:

1. The execution of this macro requires registers 0, 1, 2, 11, and 15.
2. This macro instruction should not be used when executing code that runs under control of the main JES2 task program request block.
3. Either TYPE or ELMT operands must be specified.

• Subtask, user, and functional subsystem (HASPFSSM).
• WAIT cannot occur.