IBM i / AS400 COBOL CallJob

IBM i / AS400 COBOL CallJob

Certified

Call an IBM i COBOL program synchronously

Executes an existing program on an IBM i (AS/400) system using JTOpen ProgramCall and waits for completion.

yaml
type: io.kestra.plugin.cobol.CallJob

Call a COBOL program

yaml
id: call_cobol
namespace: company.team

tasks:
  - id: call
    type: io.kestra.plugin.cobol.CallJob
    host: "{{ secret('IBM_HOST') }}"
    user: "{{ secret('IBM_USER') }}"
    password: "{{ secret('IBM_PASSWORD') }}"
    library: FINLIB
    program: CALCINT
    parameters:
      - "2026-01-31"
Properties

IBM i hostname

The hostname or IP address of the IBM i (AS/400) system.

IBM i library

The library containing the program to call (e.g., FINLIB).

IBM i password

The password for the IBM i user profile.

Program name

The name of the program to call (e.g., CALCINT).

IBM i user profile

The user profile to authenticate with on the IBM i system.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
SubTypestring
Default[]

Program parameters

List of string parameters to pass to the program. Each string is converted to EBCDIC using the system CCSID.

Program call timeout in seconds

Maximum time in seconds to wait for the program to complete. If not set, no timeout is applied.

Formatduration

Wall-clock duration of the program call

Name of the server job that ran the program

Number of the server job

User profile of the server job

Messages returned by the IBM i system

Definitions
idstring

IBM i message ID (e.g., CPF9801)

severityinteger

Message severity level

textstring

Message text