ITC

#### Search Results

Search

# ITC

File | 80
Op-Sys | BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
Statement | `FIND` / `PROCESS`
Task | Allows the execution of `INTERTASK COMMUNICATION` macros `OPCOM`, `REVNT`, `SEVNT`, `RELBF`, `CLCOM` via logical functions such as `OPEN`, `RECEIVE`. This view is available only for single-user mode.

## Common Fields for all Operating Systems

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`SYSTEM-MESSAGE-CODE` | A10 |  |  |
`SYSTEM-CODE` | B2 |  |  |
`FUNCTION` | A8 |  | D |
`INTER-TASK-COMMUNICATION-NAME` | A8 |  | D |
`ERASE` | A3 |  | D |
`MESSAGE-LENGTH` | N6 |  | D |
`MESSAGE-TEXT` | A250 |  | D |
`WAIT-TIME` | B4 |  | D |
`MESSAGE-ARRAY` | A250 | M / 5 | D |

## Relevant Error Codes

Code | Text | BS2000
--- | --- | ---
600 | Unknown function. | X
699 | Not enough main storage available. | X
735 | Logical error using ITC. | X
750 | Invalid operand within operand list. | X
752 | Message/message length missing. | X
753 | ITC name missing. | X
983 | MULTI USER MODE not supported by ITC. | X

## Field Descriptions

Field Name | Type/Length | Operating System
--- | --- | ---
`ERASE` | (A3) |

Specifies erasing of message from queue after receipt. Possible values:

Value | Explanation
--- | ---
`YES` | Default. Erase message.
`NO` | Retain message.

When the function is `CLOSE`, specifies whether all waiting messages should be erased `YES` or `NO`.

Field Name | Type/Length | Operating System
--- | --- | ---
`FUNCTION` | (A8) |

Possible values:

Value | Explanation
--- | ---
`CLOSE` | Delete an ITC.
`DELETE` | Delete the first message in the queue.
`OPEN` | Build an ITC.
`RECEIVE` | Receive message from ITC partner.
`SEND` | Send message to ITC partner.

Field Name | Type/Length | Operating System
--- | --- | ---
`INTER-TASK-COMMUNICATION-NAME` | (A8) |

Function-dependent field. Meaning per function:

Function | Meaning
--- | ---
`CLOSE` | Own ITC name.
`OPEN` | Own (new) ITC name.
`RECEIVE` | ITC name of sending ITC partner.
`SEND` | ITC name of destination.

Field Name | Type/Length | Operating System
--- | --- | ---
`MESSAGE-ARRAY` | (A250) M5 |

Array of max. 5 messages for `SEND` and `RECEIVE` functions.

Field Name | Type/Length | Operating System
--- | --- | ---
`MESSAGE-LENGTH` | (N6) |

Message length for functions `SEND` and `RECEIVE`.

Field Name | Type/Length | Operating System
--- | --- | ---
`MESSAGE-TEXT` | (A250) |

Message text. For messages longer than 250 bytes, use the `MESSAGE-ARRAY` field.

Field Name | Type/Length | Operating System
--- | --- | ---
`WAIT-TIME` | (B4) |

Maximum time (in seconds) to wait for a message. Possible values: `0` - `21599`. Default is `600`.

### On this page

- Common Fields for all Operating Systems
- Relevant Error Codes
- Field Descriptions