Dovetailed Technologies

Name

jessym — Command line interface to the JES Symbol Service

Synopsis

jessym name
jessym [-p prefix] -s name-pattern ...
jessym [-p prefix] -x name-pattern ...
jessym [-r] -c name=value ...
jessym -u name=value ...
jessym -d name-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

-p

Specifies a prefix to be added to JES Symbol names when using the (-s) or (-x) options.

-s

Prints 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'

-x

Prints 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'

-r

Specifies that when defining a new symbol (with option -c) that the value of an existing symbol of the same name may be replaced.

-c

Creates 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 -r is 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.

-u

Update 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.

-d

Delete 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

  1. Create a new JES symbol and display it by name

    > jessym -c A=B
    > jessym A
    B                                                                                                   
    
  2. Create or replace a JES symbol and display it

    > jessym -r -c A=c
    > jessym a   # symbol names are automatically folded to uppercase
    c                                                                                            
    
  3. Show symbols matching a name pattern

    > jessym -s SYS*
    SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......:                                '                                                                                         
    
  4. Generate export statements for all symbols

    > jessym -x   # defaults to * (all)
    export SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......:                                '
    export A='c'                                                                                         
    
  5. Generate export statements for all symbols, using a name prefix

    > jessym -p JES_ -x   
    export JES_SYS_CORR_CURRJOB='S0000434DTLZOS01CC27C5EA.......:                                '
    export JES_A='c'                                                                                         
    
  6. 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
    
  7. 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
    
  8. Delete a symbol

    > jessym -d A
    > jessym A
    JesSymbols[W]: IAZSYMBOL rc=0 RET=4 REAS=4
    
Copyright© 2009-2017 Dovetailed Technologies, LLC. All rights reserved.
Co:Z® is a registered trademark of Dovetailed Technologies, LLC.