GDSX (Extended General Device Support) Manual

Service Routines

Extended General Device Support (GDSX) Manual—529931-001

8-84

VSEM

indicates the outcome of the call. The value of status is one of the following:

record-size input

INT:value

specifies the maximum size of each record added to the trace file. The default is

256 words and the maximum is 16,383 words.

segment-size input

INT:value

specifies the number of extent pages. Segment-size must be less than or equal to

64. The default is 64.

record-count input

INT(32):value

specifies the maximum number of records that can be generated for the trace file

before the entries wrap. The default is 4,096D and the maximum is 32,000D.

Example

See the examples included with the description of the procedure ADD^TRACE^DATA

on page 8-7.

VSEM

This procedure releases a noncheckpoint semaphore so that other tasks can use the

associated resource. The checkpoint semaphore is released with the GIVE^CPSEM

procedure.

Any error-handling or special handling after accessing a resource should be done

before calling VSEM. When a task calls VSEM, TSCODE verifies that the caller owns

the semaphore, then checks the semaphore’s wait list. If this list is not empty, the first

task on the list is given the semaphore and an E^RESOURCE event is caused for the

task.

-1 The trace file could not be opened

0 Successful open

1 The trace file is already open

CALL VSEM ( semaphore ); !