DIR.SET.USER.APPENDAGE
ADAPTER_TYPE Explanation:
ADAPTER_TYPE Explanation:
For CCB2 and CCB3: The network adapter type as indicated below:
X10001 1 Token-Ring Network PC Adapter X'0002 1 Token-Ring Network PC Adapter II X'0004 1 Token-Ring Network Adapter/A X'0008 1 Token-Ring Network PC Adapter II X'0020 ' Token-Ring Network 16/4 Adapter X'0040 ' Token-Ring Network 16/4 Adapter/A X '0080 ' Token-Ring Network Adapter/A X 14000 1 PC Network adapters
X 18000 1 PC Network adapters
DIR.TIMER.CANCEL
j:
Hex 23DlR.TIMER.CANCEL
Command Description: This command cancels a timer that was previously initiated by a DIRTIMER.SET command.
Command Specifics: This command is executed entirely in the PC system. The return code is available to the application program upon return from the adapter support software.
When the DIRTIMERCANCEL command is completed, the DIRTIMERSET command is terminated with a CCB_RETCODE value of X lOA I , and the DIR.TIMER.SET command is not posted except for the setting of the return code. The following CCB field points to the address of the DIR.TIMER.SET command that is to be cancelled.
For CCB1: The CCB_PARM_TAB field.
For CCB2 and CCB3: The CCB_PARM_OFFSET and CCB_PARAMETER_1 fields are combined to form a four byte (8086 declaration type DD) address of the timer to be cancelled.
Valid Return Codes: see "CCB Return Codes Listed by Command" on page B-4.
OIR. TIMER.CANCEL.GROUP
DIR.TIMER.CANCEL.GROUP
j:
Hex2CDlR. TIMER.CANCEL.GROUP
Command Description: This command cancels a group of timer commands that were previously initiated by DIR.TIMER.SET commands.
Command Specifics: This command is executed entirely in the PC system. The return code is available to the application program upon return from the adapter support software.
For CCB1: The CCB_PARM_TAB field points to the address of a timer completion appendage. All timers that have that address as a timer completion appendage will be terminated with a return code of X'OA I . When the DIR.TIMER.SET command is terminated, the command completion appendage will not be taken. All canceled CCBs will be pointed to by the CCB_POINTER field of the DIR.TIMER.CANCEL.GROUP command. This command may be issued while the adapter is closed.
For CCB2: The DIR.TIMER.CANCEL.GROUP command's CCB_PARM_OFFSET and CCB_PARAMETER_1 fields contain a TIMER_CMPL_FLAG. All timer set commands that have been issued with their CCB_CMPL_FLAG equal to the TIMER_CMPL_FLAG will be cancelled with a CCB_RETCODE of X'OA'.
No command completion is done for the DIR.TIMER.SET commands other than setting the CCB_RETCODE to X'OA I . The DIR.TIMER.SET command's CCBs are chained using the CCB_POINTER field of the DIR.TIMER.CANCEL.GROUP command CCB.
For CCB3: The DIR.TIMER.CANCEL.GROUP command's CCB_PARM_OFFSET and CCB_PARAMETER_1 fields contain a TIMER . .:..CMPL..:,OFFSET. This offset is used to specify the address of the command completion appendage (CCB_APPNDG_OFFSET) of all outstanding DIR.TIMER.SET commands that are to be cancelled. These commands will be cancelled with a CCB_RETCODE of X'OA'.
No command completion is done for the DIR.TIMER.SET commands other than setting the CCB_RETCODE to X'OA I . The DIR.TIMER.SET command's CCBs are chained using the CCB_POINTER field of the DIR.TIMER.CANCEL.GROUP command CCB.
Valid Return Codes: see "CCB Return Codes Listed by Command" on page B-4.
DIR.TIMER.SET
~
Hex 22mR.TIMER.SET
PDT.TRACE.ON
Command Description: This command sets a special programmable timer to expire in some multiple of half-second periods. On the PC Network, the value is not actually half-seconds, but 491.5 millisecond periods.
• For the Token-Ring Network: From 0 to 13,107 (109 minutes)
• For the PC Network: From 0 to 13,107 (107.3 minutes) The timer expires after the next tick if the value is set to zero.
Command Specifics:
For CCB1: The timer value is coded in the first two bytes of the CCB_PARM_ TAB field.
When the specified time expires, the command completes, with the CCB_RETCODE set to X'OO'.
This command may be issued any time after the adapter has been initialized while the adapter is either open or closed, but if a command follows that changes the adapter open/closed state, all outstanding timers will be canceled. The number of timers that may be set is limited only by the number of commands that may be outstanding.
For CCB2: The timer value is coded in the CCB_PARM_OFFSET field.
When the allotted time expires, the command completes as defined by the CCB_CMPL_FLAG and the CCB_SEMAPHORE parameters with the CCB_RETCODE set to X'OO'.
For CCB3: The timer value is coded in the CCB_PARM_OFFSET field.
When the allotted time expires, the command completion appendage will be called, if defined.
The CCB RETCODE is set to X I 00 I •
Valid Return Codes: see "CCB Return Codes Listed by Command" on page B-4.
PDT.TRACE.ON
r:
PDT.TRACE.ON Hex 24 Command Description:This command is for CCB1 only:
This command provides an interrupt trace for all adapter traffic.
Command Specifics: The command provides entries for the following activities:
• Each CCB when it is issued to the adapter if the initial return code is X I FF I .
• Each CCB completion
• Each NCB when issued by the application program (return code
=
X I FF ')• All adapter interrupts to the PC system. If the interrupt is a timer interrupt only, a trace entry is not made, but the timer interrupts are counted for reporting. Then when a non-timer interrupt occurs, a
PDT.TRACE.ON
timer trace entry is made containing the accumulated timer interrupts followed by a trace entry for the non-timer interrupt.
Only one trace command can be active. The trace includes all activity for either primary or alternate adapter or both. The command is terminated by either a PDT.TRACE.OFF command or an exception, when issued.
This command is executed entirely in the adapter support software in the PC system. Therefore, the command completion appendage is not required, as the command is complete upon return. However, the command completion appendage will be taken if provided.
The CCB_ADAPTER field of the CCB may be any value between X100 1 and X 103 1.
The location of the trace table is pointed to by the value placed in the CCB_PARM_TAB field by the application program. The trace will wrap when the buffer fills.
Valid Return Codes: see "CCB Return Codes Listed by Command" on page B-4.
CCB Parameter Table
OFF- PARAMETER NAME BYTE 8086 DESCRIPTION
SET LEN TYPE
For CCB1 only:
0 TABLE_LENGTH 2 OW Length of the TRACE _TABLE
2 CURRENT_OFF 2 DB Offset of the current trace entry *
4 START_TICK_O 4 DO Adapter 0 timer tick count, trace start *
8 STOP _TICK_O 4 DO Adapter 0 timer tick count, trace stop *
12 START _TICK_1 4 DO Adapter 1 timer tick count, trace start * 16 STOP _ TICK_1 4 DO Adapter 1 timer tick count, trace stop *
20 12
--
Adapter work area32
-- --
Trace table* Indicates a returned value.
TABLE_LENGTH
Explanation: The length of the requested trace table with a minimum value of 256. The entries are 16 bytes long. If the length specified is not a multiple of 16, the last 1-15 bytes will be unused.
CURRENT_OFF
Explanation: The offset from the TRACE_TABLE value of the most recent table entry.
The table will wrap around when full. If the first entry in the table is the PDT.TRACE.ON command, the table has not wrapped.
START _ TICK_O
Explanation: The value of the Adapter 0 timer tick counter, as set by the adapter, when the trace started.
Adapter ticks occur every 100 milliseconds.
STOP _TICK_O
Explanation: The value of the Adapter 0 timer tick counter, as set by the adapter, when the trace stopped.
PDT.TRACE.ON
START_TICK_1
Explanation: The value of the Adapter 1 timer tick counter, as set by the adapter, when the trace started.
STOP _TICK_1
Explanation: The value of the Adapter 1 timer tick counter, as set by the adapter, when the trace stopped.
TRACE_TABLE
Explanation: The trace table starts here. The length is defined by the TABLE_LENGTH field. The trace table formats for the Token-Ring Network and the PC Network are explained below: