OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Object Classes and Attribute Types
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
3-140
EDI-C-EDI-APP-SECUR-ELTS
For outbound messages, the client program should specify OM-S-ONFILE-STRING
as the syntax of an attribute when the memory storage space might be insufficient to
accommodate the value of the attribute. The client can specify this syntax for
specific strings when the accumulated length of the strings might overflow the total
string area specified in the max-table-data parameter of the GPI_INITIALIZE_
procedure call.
For inbound messages, the Gateway Interface Process automatically specifies OM-
S-ONFILE-STRING for those strings that exceed the value in the max-table-data
parameter of the GPI_INITIALIZE_ call or that exceed the maximum length
specified in the max-in-memory-string-len parameter of the
GPI_MT_START_TRANSFER_IN_ call.
Attributes that have the syntax OM-S-ONFILE-STRING are treated as long strings,
regardless of their actual length: that is, they are treated as if they were longer than
the specification of the max-string-len parameter of GPI_INITIALIZE_. Thus, you
can use only the procedure calls GPI_OM_READ_ and GPI_OM-WRITE_ to read
and write the values of strings that have the syntax OM-S-ONFILE-STRING.
EDI-C-EDI-APP-SECUR-ELTS
This class of object identifies a set of security elements. This class is used to allow an
application to exchange security elements that have significance to the originator and
recipients. This class is contained in both EDIMs and EDINs.
Table 3-99
describes the attribute types for this class and the syntax, length, and number
of values for each type.
Some attribute types have additional value characteristics, as shown in Table 3-100
.
Table 3-99. EDI-C-EDI-APP-SECUR-ELTS Attributes—General Characteristics
Attribute Type Value Syntax
Value
Length
Number of
Values
EDI-T-EDI-APP-SECUR-ELE-
MENT
OM-S-BIT-STRING
or
OM-S-ONFILE-STRING
0-1025 0-1
1
EDI-T-EDI-APP-SECUR-EXTEN-
SIONS
OM-S-OBJECT
(EDI-C-EDI-EXTENSION)
- - 0-more
EDI-T-EDI-ENCRYPTED-PRI-
MARY-BP
OM-S-BOOLEAN - - 0-1
OM-T-CLASS OM-S-OBJECT-ID-STRING 7 1
1
The value length of an attribute of syntax OM-S-BIT-STRING is specified in units of octets. The first octet
of the value specifies the number of unused bits in the last octet. The first octet must contain a value in the
range of 0 through 7. The maximum number of bits allowed for EDI-T-EDI-APP-SECUR-ELEMENTS is
8191, not including bits of the first octet. This implies a maximum length of 1025 octets; one octet to indi-
cate the number of unused bits, followed by 1024 octets for the data string (1023 octets that are filled com-
pletely, and a last octet that has one unused bit).