Administration Guide > Configuration > Structure of the Configuration Files > Utility for z/OS

Utility for z/OS

Structure of the INI File UCXBM25C.INI

Section/Parameter Description
(GLOBAL)  

system=

Name of the AE system

This entry must be identical to the entry in the INI file of the Automation Engine.

helplib=

Name of the message file

language=

Language in which the logging is executed. Entries for primary and secondary language.

Allowed values: "E", "D", "F"
Default: "E,D" (Primary English, secondary German)

If there is no log in the primary language, a log in the secondary language is searched for.

timeout=

Time in seconds during which the CallAPI waits for a response from AE. If this is exceeded, the CallAPI ends with a timeout error.

Default value: 60

With the parameter timeout=0 being used, the CallAPI waits (without time limit) until the Automation Engine acknowledges.

codetable=

Name of the CodeTable object that should be used by the CallAPI

The IBM standard code table is used if nothing is specified in this parameter.

queue=

Specification of a particular Queue object in which the CallAPI should be executed.

This parameter overrides the setting API_QUEUEin the variable UC_CLIENT_SETTINGS.

(USER)

 

client=

Logon specifications: Client

Logon data from this section is used when no logon data is specified at service-program call

user=

Logon specifications: Name of the user

dept=

Logon specifications: Department of the user

pass=

Logon specifications: Password (optional)

(CP_LIST)

Address of the communication processes in the AE system

Allowed formats:
Port number=DNS Name
Port number=TCP/IP Address

Example of an INI File

(GLOBAL)
system=UC4
helplib='UC4.UC.MSL'
language=(E,D)
timeout=60
;queue=


(USER)
client=
user=
dept=
pass=


(CP_LIST)
2217=uc4srv01
; 2218=uc4srv02

Activating Trace for z/OS CallAPI Utility

CallAPI trace for z/OS agents is set activated/deactivated on the command line.

Allowed values:
"N" (default) = Deactivate trace
"Y" = Activate trace

For example: 

TRACE=Y

Once tracing has been activated with TRACE=Y, the CallAPI writes the trace to the location specified in the TRACE DD card:

//TRACE DD SYSOUT=*

or

//TRACE DD DSN=datsetname,....

 

See also: