The following document includes information and notes required for using the CallAPIA programming interface that processes a script in the Automation Engine system. It can be called directly from within the program itself or from a different program. for z/OS.
Define the CodeTable to be used in the INI file of the z/OS CallAPI. Enter the name of the CodeTable objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task in the parameter codetable= of the section [GLOBAL]. IBM's default code tableAn Automation Engine object type that defines a complete set of characters. is used if this parameter is empty.
![]() |
1. |
CallAPI and own program |
---|
The AE CallAPI can be called from your own program. This requires sound knowledge of the programming language in which this program was written.
![]() |
2. |
CallAPI and utility |
---|
The delivery directory includes the utility UCXBM25C which is available in the load library. It can be used in z/OS jobs.
The AE Script which is to be processed in the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes. is read from SYSIN.
You can also use the data definition instead of the dataset names (see example).
If the utility should be used in a jobAn Automation Engine object type for a process that runs on a target system., the userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management. must be authorized to communicate via TCP/IP.
Dataset names must be adjusted to your installationation and z/OS configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied..
//UC4JOB JOB ......
//UCCALL EXEC PGM=UCXBM25C,REGION=2M,
// PARM='INI=UC4.UCXBM25C.INI LOGON=0004,SMITH,UC4'
//STEPLIB DD DSN=UC4.UCXJM25.LOAD,DISP=SHR
//* You can use the following command
//* instead of the PARM INI=AE-inifile
//*UCINI DD DSN=AE-inifile,DISP=SHR
//SYSIN DD *
:SET &RUNNR = ACTIVATE_UC_OBJECT(JOBS,ExampleL1)
:IF &RUNNR = '0000000'
: SET &ERROR = SYS_LAST_ERR_NR
: STOP MSG,51,'ACTIVATION ERROR: &ERROR'
:ELSE
: STOP NOMSG,50,'JOB WAS STARTED WITH RunID &RUNNR'
:ENDIF
/*
//
See also:
About the CallAPI
Using the CallAPI
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |