JESALLOC


Unlike the TSO ALLOCATE command, you can use this command to allocate a subsystem data set even when a JES connect was performed, which occurs when JES is started after the BMC AMI Ops Automation subsystem is started.

If the MVS Dynamic Allocate service detects errors, TSO/E generates IKJnnnn messages that are written to the BBI Journal.


Command

Parameters

JESALLOC

DDNAME

[CLASS]

[SYSOUT]

[DEST(parm | dest,parm)]

The following table describes the parameters:

Parameter

Function

Notes

DDNAME

Name of the DD statement that is be allocated

The maximum length is eight characters and must conform to the DD name specifications.

CLASS

Class to be associated with this SYSOUT DD statement.

This parameter is a one-character valid JES output class. Specify an asterisk (*) for the MSGCLASS of the STC.

SYSOUT

A literal indicating that this DD statement should be allocated to SYSOUT

Code this parameter to be compatible with future extensions to this command.

DEST

The DEST parameter for DDNAME which can be DEST=parm or DEST=(dest,parm)

See the IBM publication MVS JCL Reference for information about valid values for the dest and parm keywords.

Condition codes are listed in the following table:

Value

Description

0

Command was executed successfully.

4

JES rejected the allocation request.

8

Not connected to JES (started under MSTR and no JESCNCT card in BBISSP00)

16

Syntax error occurred.

20

DD name is in use (use TSO free command first).

Example 1

This REXX example shows how to allocate a SYSOUT data set in the SYSOUT class A to the DD statement ‘MYPRINT’.

/* REXX */
"IMFEXEC JESALLOC MYPRINT SYSOUT CLASS(A)"

CLIST example:

IMFEXEC JESALLOC MYPRINT SYSOUT CLASS(A)
Warning

Important

You can use the TSO FREE command to free this DD statement again.

Example 2

The following example shows how to use the DEST parameter:

/* REXX */
s.0 = 3
s.1 = 'line1'
s.2 = 'line2'
s.3 = 'line3'
dd = 'DD1'
"IMFEXEC JESALLOC "dd" CLASS(R) SYSOUT DEST(BBSYSA,EK1)"
jrc=imfcc
"IMFEXEC MSG '."exname "JESALLOC IMFCC="jrc"'"
if jrc = 0 then do
address mvs "EXECIO * DISKW "dd" (STEM s. OPEN FINIS"
"IMFEXEC MSG '."exname 'EXECIO rc='rc"'"
end
"FREE F("dd")"

Example 3

The following REXX statement specifies an invalid destination for the DEST parameter:

/* REXX */
"IMFEXEC JESALLOC "dd" CLASS(R) DEST(SJSC,baoeuk)"

This statement causes the following messages to be issued to the BBI Journal:

EM0026I  EXEC JAL1     EID= 00003 STARTED ON 19-JUL-11 AT 09:36:14
EM0025I  FOLLOWING MSG ISSUED FOR EXEC .. JAL1     ..
IKJ56875I  SYSOUT DATA SET NOT ALLOCATED, DESTINATION UNDEFINED TO SUBSYSTEM
EM0022E ERROR PROCESSING .. JAL1     .. Error processing JESALLOC

In the following REXX statement, the DEST parameter specifies a destination name that exceeds the maximum length allowed:

/* REXX */
"IMFEXEC JESALLOC "dd" CLASS(R) DEST(bbsysa,ek1abcnde)"

This statement causes the following messages to be issued to the BBI Journal:

EM0025I  FOLLOWING MSG ISSUED FOR EXEC .. JAL1     ..
IKJ56702I INVALID DEST2, ek1abcnde

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.4