Name
jessym — command line interface to the JES Symbol Service
Synopsis
jessym name jessym [-pprefix]-sname-pattern ... jessym [-pprefix]-xname-pattern ... jessym [-r]-cname=value ... jessym-uname=value ... jessym-dname-pattern ...
Description
This z/OS Co:Z utility uses the JES Symbol Service (IAZSYMBL) to extract, create, update, and delete JES system symbols. Requires z/OS 2.1 or later.
Options
-pSpecifies a prefix to be added to JES Symbol names when using the (
-s) or (-x) options.-sPrints the value of one or more JES Symbols whose name matches a
name-pattern. Characters in a name pattern are automatically folded to upper case and may include*or?characters to match zero-or-more or exactly-one characters respectively. If no name-patterns are given, then the default is*(all names). Each line is displayed on stdout in the form: NAME='VALUE'-xPrints an export command with the value of one or more JES Symbols whose name matches a
name-pattern. Characters in a name pattern are automatically folded to upper case and may include*or?characters to match zero-or-more or exactly-one characters respectively. If no name-patterns are given, then the default is*(all names). Each line is displayed on stdout in the form: export NAME='VALUE'-rSpecifies that when defining a new symbol (with option
-c) that the value of an existing symbol of the same name may be replaced.-cCreates one or more new symbols given arguments of the form:
NAME=VALUE. Characters in the name (but not the value) are folded to uppercase automatically. If the-ris also specified, then the value of an existing symbol with the same name will be replaced. Symbols will be created at the job (address space) level.-uUpdate one or more existing symbols with a new value given arguments of the form:
NAME=VALUE. Characters in the name (but not the value) are folded to uppercase automatically. The symbols must previously exist; a new symbol will not be created.-dDelete one or more symbols that match the given name pattern(s). Characters in a name pattern are automatically folded to upper case and may include
*or?characters to match zero-or-more or exactly-one characters respectively.
See Also
The todsn command has been enhanced for z/OS 2.1 to support passing JES symbols to jobs submitted to the internal reader.
The COZBATCH utility has been enhanced for z/OS 2.1 so that the values of all JES symbols will be automatically
exported as environment variables with a prefix of JES_.
Examples
Create a new JES symbol and display it by name
> jessym -c A=B > jessym A B
Create or replace a JES symbol and display it
> jessym -r -c A=c > jessym a # symbol names are automatically folded to uppercase c
Show symbols matching a name pattern
> jessym -s SYS* SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......: '
Generate export statements for all symbols
> jessym -x # defaults to * (all) export SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......: ' export A='c'
Generate export statements for all symbols, using a name prefix
> jessym -p JES_ -x export JES_SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......: ' export JES_A='c'
Generate export statements for all symbols, using a name prefix, and pipe these as commands into the current shell. Note that this is done automatically by the COZBATCH utility.
> set -o pipecurrent # this shell option required to use the current shell > jessym -p JES_ -x | . /dev/fd0 > echo $JES_A c
Display one symbol and read its value into a shell variable
> set -o pipecurrent # this shell option required to use the current shell > jessym A | read myA > echo $myA c
Delete a symbol
> jessym -d A > jessym A JesSymbols[W]: IAZSYMBOL rc=0 RET=4 REAS=4
