EXTERNAL-POINTER es un Reference de designación que señala el LOCAL ID de un documento importado con IMPORT-DOC en HEAD.

ElementoValor
NombreEXTERNAL-POINTER-2WORD (grupo 5Q. Los nombres por código están en la tabla de miembros más abajo)
TAG ID0x025L~0x029L
Sección1 0001 (Reference EXTERNAL), desplazamiento dentro de la sección C = 5~9
KindReference · clasificación: designación
Lado Hugoreference/external-pointer.md (esa página trata también EXTERNAL-POINTER-1WORD y EXTERNAL-POINTER-4WORD)

Miembros

Esta página trata un conjunto del sistema 5Q, cinco códigos a la vez. La cuantificación es el desplazamiento dentro de la sección C % 5 (Reference). Hay un documento de Codec por código. Los campos de los cinco documentos de Codec son iguales; solo difieren el destino de DECLARE y el nombre (BIND).

TAG IDNombreCuantificaciónCodec IDDocumento de especificaciónTAG WORD
0x025LEXTERNAL-POINTER-2WORD-IDENTIFIEDIdentified0x000002500x00000000/codecs/0x00000250/0000 0010 0101 LLLL
0x026LEXTERNAL-POINTER-2WORD-GENERICGeneric0x000002600x00000000/codecs/0x00000260/0000 0010 0110 LLLL
0x027LEXTERNAL-POINTER-2WORD-FREE-CHOICEFree-choice0x000002700x00000000/codecs/0x00000270/0000 0010 0111 LLLL
0x028LEXTERNAL-POINTER-2WORD-UNIVERSALUniversal0x000002800x00000000/codecs/0x00000280/0000 0010 1000 LLLL
0x029LEXTERNAL-POINTER-2WORD-VARIABLEVariable0x000002900x00000000/codecs/0x00000290/0000 0010 1001 LLLL

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (Documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato aceptado (CODEC)ENUM
1import-id#2valor en bruto de 2 WORD
2target-id#3resto en valor en bruto (0xFFFF)

EXTERNAL-POINTER es un Reference de designación que señala el LOCAL ID de un documento importado con IMPORT-DOC en HEAD.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (sección 1)
[TAG de extensión de Length]
IMPORT ID         ancho fijado por el Codec (1/2/4 WORD)
ID de destino     todo el resto. LOCAL ID del documento importado, en el ancho más corto
Codec (Identified, Generic, Free-choice, Universal, Variable)NombreAncho del IMPORT ID
0x020L~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 WORD
  • El ancho lo fija el número de sistema: si sistema − 6 (C / 5, con C el desplazamiento dentro de la sección) es 0, 1 o 2, el ancho es 1, 2 o 4 WORD. La cuantificación es C % 5.

  • Se usa el Codec más estrecho en el que quepa el valor del IMPORT ID.

  • El IMPORT ID es el valor que asignó el IMPORT-DOC de este documento. En EXTERNAL-POINTER no se escribe el Issuer. El Issuer y el ID de documento se obtienen de ese IMPORT-DOC. La versión también la fija ese IMPORT-DOC (fija o la más reciente).

  • Si es el mismo LOCAL ID del documento importado, es el mismo objeto tanto si dentro de ese documento se usa como LOCAL como si aquí se usa como EXTERNAL-POINTER.

  • Si es Variable, es la variable LOCAL del documento importado.

Validez

  • Es invalid si en este documento no hay un IMPORT-DOC que haya asignado ese IMPORT ID.
  • Si el IMPORT ID cabe en un Codec más estrecho y se usa uno más ancho, se rechaza por non-minimal.
  • Es invalid si el ID de destino es 0. El propio documento importado se señala con DOC-POINTER.
  • Se prohíbe un WORD 0x0000 inicial en el ID de destino.

Ejemplo

DestinoWORD sequence
LOCAL 5 del IMPORT ID 10202 0001 0005
LOCAL 65536 del IMPORT ID 10203 0001 0001 0000
LOCAL 5 del IMPORT ID 700000253 0001 1170 0005

Páginas relacionadas

Texto original del documento de especificación

Así se ve el documento de especificación 0x00000000/codecs/0x00000250/latest.geul leído con geul show (hexadecimal en mayúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000025000000000
BODY
#1 DECLARE 0x0250
#2 FIELD #1 0x0002
#3 FIELD #1 rest
#4 BIND #1 "EXTERNAL-POINTER-2WORD-IDENTIFIED"
#5 BIND #2 "import-id"
#6 BIND #3 "target-id"

Lo anterior es el documento de Codec de EXTERNAL-POINTER-2WORD-IDENTIFIED (0x025L). En los documentos de Codec de los demás miembros (EXTERNAL-POINTER-2WORD-GENERIC, EXTERNAL-POINTER-2WORD-FREE-CHOICE, EXTERNAL-POINTER-2WORD-UNIVERSAL, EXTERNAL-POINTER-2WORD-VARIABLE) solo difieren el Codec ID del DOC-ID, el destino de DECLARE y el nombre asociado en #1 (BIND).