ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-8
1. They can contain no more than five logical, hierarchical levels, using the
backslash (\) character as a level separator. The name cannot begin with a
backslash.
2. The ASAP Entity name for this domain must be the leftmost level of the
domain name.
3. The entity must be defined in ASAP EDL and must be loaded into the copy of
ASAP referenced by the ASAP ID parameter on the NonStop servers
configured to accept data from the Linux system.
4. The name must be null-terminated.
5. The name cannot exceed ASAP_MAX_DOMAIN_NAME_LENGTH bytes in
length, not including the terminating null.
6. The name cannot contain a space, quote, comma, colon, semicolon, or
asterisk.
7. All domain names must be unique. ASAP can optionally append the process
ID of the calling process as the final level of the domain name if desired.
However, such IDs are generic and not repeatable, so the current process will
probably not be assigned the same ID the next time it is run. Thus an
application-specific name is preferred. You can use the concat_ind parameter
to specify whether or not ASAP should automatically append the process ID
to the domain name.
This parameter is required.
void **ptr_handle
A handle for the shared memory allocated to this domain. This handle must be
maintained and passed to all subsequent calls to the ASAP API when you update
this domain. This parameter is required.
short *ptr_error_detail
A detailed error code, if any. This parameter is optional. The default value is
NULL, which means no detailed error code is returned.
const char *ptr_asap_id
The null-terminated, up to ASAP_MAX_ID_LENGTH character ID of the ASAP
environment on the NonStop server into which this domain will register. This
parameter is optional. The default value is NULL, which causes ASAP to use the
default ASAP ID configured on the NonStop server. If specified, the ID must
begin with a dollar sign ($) and must be at least 2 bytes long ($ + at least 1
character). In addition, the first character following $ must be alphabetic, and any
remaining characters must be alphanumeric.