z/OS JCL variables

The following table lists all the JCL variables that you can customize in alphabetical order, together with a description and an example value.

JCL variable Description Example value
Start of change++ACTIVEUSEREXITLIST++End of change Start of changeActive user exit listEnd of change Start of change'MyExit1: MyExit2'End of change
++ARM++ Specifies if a component should use Automatic Restart Management (ARM). YES
++ARMNAME++ ARM name. Required if ++ARM++ is set to YES. Q482BRK
++ARMTYPE++ ARM type. Required if ++ARM++ is set to YES. SYSWMQI
++COMPONENTDATASET++ The dataset where all JCL relevant to a particular component is saved. TESTDEV.MQP1BRK.BROKER
++COMPONENTDIRECTORY++ The file system directory where the component exists. This directory includes subdirectories, for example, /log and /registry mqsi/brokers/MQP1BRK
++COMPONENTNAME++ The name you give the component when you create it. MQP1BRK
++COMPONENTPROFILE++ Profile name. BIPBPROF, BIPCPROF, or BIPUPROF
++COMPONENTRESOURCE++ Required specifically by BIPBRWS. It represents the resource to be displayed. BNBRCONNECTIONS
++DB2BUFFERPOOL++ The name of the DB2 buffer pool associated with the component for which the JCL is submitted. BP0
++DB2CONVERSION++ Specifies the DB2 Converter. SINGLE
++DB2CURRENTSQLID++ The DB2 user ID for the component and commands. MQP1BRK
++DB2DATABASE++ The name of the DB2 database associated with the component for which the JCL is submitted. DMQP1BRK
++DB2HLQ++ DB2 high-level-qualifier SYS2.DB2.V710
Start of change++DB2INDEXBP++End of change Start of changeDB2 index bufferpoolEnd of change Start of changeBP0End of change
Start of change++DB2LOBBP++End of change Start of changeDB2 LOB table bufferpoolEnd of change Start of changeBP0End of change
++DB2LOCATION++ The DB2 location value of the DB2 subsystem to which the component connects. DSN710PK
++DB2PLAN++ The DB2 plan value. DSNTEP71
++DB2PLANNAME++ The DB2 plan name. DSNACLI
++DB2PROGRAM++ The DB2 program value. DSNTEP2
++DB2RUNLIB++ The DB2 run library value. DSN710PK.RUNLIB.LOAD
++DB2STORAGEGROUP++ The name of the DB2 storage group associated with the component for which the JCL is submitted. MQP1STOR
++DB2SUBSYSTEM++ The DB2 subsystem ID which the component connects. DFK4
++DB2TABLEOWNER++ Broker tables schema name. MQP1BRK
++EXECUTIONGROUPNAME++ The name of an execution group. Default
++HOME++ The file system home directory for the component’s user ID. This is required to dynamically generate the ENVFILE from BIPBPROF, and is also used for STDOUT and STDERR output.

You must have the appropriate RACF authorities to write to this file system directory when submitting JCL to run a command.

/u/mqp1brk
Start of change++INACTIVEUSEREXITLIST++End of change Start of changeInactive user exit listEnd of change Start of change'OtherExitA: OtherExitB'End of change
++INSTALL++ The directory where you install the product. /usr/lpp/mqsi
++JAVA++ Location of Java installation. /usr/lpp/java/IBM/J1.4
++LANGLETTER++ The letter for the language in which you want messages shown. E (English)
++LOCALE++ Locale of environment where commands are run by submitting JCL. C
++MESSAGECASE++ Determines if messages should appear in mixed case. YES
Start of change++MESSAGEFLOWNAME++End of change Start of changeName of the message flowEnd of change Start of changeMyTestMsgFlowEnd of change
Start of change++MQPATH++End of change Start of changeWebSphere MQ locationEnd of change Start of change/usr/lpp/mqmEnd of change
++NEIGHBOURQUEUEMANAGER++ Required specifically by BIPCLMP for the mqsiclearmqpubsub command. It represents the name of the neighboring QueueManager MQP1
++OBJECTNAME++ Required specifically by BIPRPPR for the mqsireportproperties command. It represents the name of the object. DynamicSubscriptionEngine
++OPTIONS++ Many commands submitted by JCL require additional options. See each command's reference material for additional information on options specific to that command. N/A
++PARENTQUEUEMANAGERNAME++ Required specifically by BIPJNMP for the mqsijoinmqpubsub command. It represents the name of the parent QueueManager. MQP1
++PROPERTYNAME++ Required specifically by BIPCHPR for the mqsichangeproperties command. It represents the name of the property to be changed. multicastEnabled
++PROPERTYVALUE++ Required specifically by BIPCHPR for the mqsichangeproperties command. It represents the new value of the property to be changed. false
++QUEUEMANAGER++ The name of the QueueManager associated with the component for which you submit the JCL. MQP1
++STARTEDTASKNAME++ Name of the Started Task JCL. This can be a maximum of 8 characters. MQP1BRK
++TIMEZONE++ Time zome of environment where commands are run by submitting JCL. GMT0BST
Start of change++WMQHLQ++End of change Start of changeWebSphere MQ high-level-qualifierEnd of change Start of changeMQM.V531End of change
Start of change++XMLTOOLKIT++End of change Start of changeIBM XML Toolkit locationEnd of change Start of change/usr/lpp/ixm/IBM/xml4c-5_5End of change
Related tasks
Collecting the information required to create a broker