ITC

File 80
Op-Sys BS2000/OSD
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/OSD
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.