Condividi tramite

GET_TP_PROPERTIES

  • Articolo

Il verbo GET_TP_PROPERTIES restituisce attributi del programma di transazione (TP) e della transazione corrente.

La struttura seguente descrive il blocco di controllo verbo usato dal verbo GET_TP_PROPERTIES verbo.

Sintassi

  
struct get_tp_properties {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   lu_alias[8];  
    unsigned char   luw_id[26];  
    unsigned char   fqlu_name[17];  
    unsigned char   reserve3[10];  
    unsigned char   user_id[10];  
    unsigned char   prot_luw_id[26];  
    unsigned char   pwd[10];  
};

Members

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_GET_TP_PROPERTIES.

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo. Se il bit di AP_EXTD_VCB è impostato, questo indica che la struttura get_tp_properties include il membro prot_luw_id usato per il supporto del punto di sincronizzazione. In caso contrario, il blocco di controllo verbo termina immediatamente dopo il membro user_id .

reserv2
Campo riservato.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

Tp_id
Parametro fornito. Identifica il TP locale. Il valore di questo parametro è stato restituito da TP_STARTED nella chiamata TP o da RECEIVE_ALLOCATE nel TP richiamato.

Tp_name
Parametro restituito. Specifica il nome TP del TP che ha rilasciato il verbo. Il nome viene restituito come stringa EBCDIC a 64 byte, riempita a destra con spazi EBCDIC.

Lu_alias
Parametro restituito. Specifica il nome dell'alias assegnato all'lu locale. Viene restituito come stringa ASCII a 8 byte riempita a destra con spazi ASCII.

luw_id
Parametro restituito. Fornisce l'identificatore di unità logica non protetta per la transazione in cui partecipa il TP. È possibile coinvolgere diversi provider di servizi di rete in una transazione. Questo identificatore, assegnato per conto del TP che avvia la transazione, consente alla conversazione che costituisce la transazione di essere connessa logicamente.

Il luw_id può essere rappresentato come struttura luw_id_overlay con i campi seguenti:

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

Lunghezza di 1 byte del nome lu completo per l'lu dell'origine TP.

luw_id.fqla_name

Nome completo dell'LU per il TP di origine. Il nome viene restituito come stringa EBCDIC a 17 byte, costituita da NETID, un punto e il nome LU. Se la lunghezza del nome è inferiore a 17 byte, i numeri di istanza e sequenza seguono immediatamente. Si noti che a causa di questo motivo non è consigliabile usare i campi della struttura luw_id_overlay per accedere a tali valori. Sono disponibili solo per la compatibilità.

luw_id.instance

Stringa a 6 byte generata in modo univoco dall'LU per il TP di origine.

luw_id.sequence

Numero a 2 byte che indica il segmento di unità di lavoro. Questa opzione è sempre impostata su 1, se il punto di sincronizzazione non è supportato.

Se la lunghezza luw_id è minore di 26 byte, viene riempita a destra con spazi EBCDIC.

fqlu_name
Parametro restituito. Specifica il nome completo dell'LU locale. Il nome viene restituito come stringa EBCDIC a 17 byte, costituita da NETID, un punto e il nome LU. Il nome viene riempito a destra con spazi EBCDIC.

riserva3
Campo riservato.

User_id
Parametro fornito. Indica la user_id fornita dall'avvio TP nella richiesta di allocazione. Il nome viene fornito come stringa EBCDIC a 10 byte, riempita a destra con spazi EBCDIC.

prot_luw_id
Parametro restituito. Contiene l'identificatore di unità logica protetta per la transazione in cui partecipa il TP, se la conversazione è stata allocata con punto di sincronizzazione sincrona .

È possibile coinvolgere diversi provider di servizi di rete in una transazione. Questo identificatore, assegnato per conto del TP che avvia la transazione, consente alla conversazione che costituisce la transazione di essere connessa logicamente.

Il prot_luw_id può essere rappresentato come struttura luw_id_overlay con i campi seguenti:

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

Lunghezza di 1 byte del nome lu completo per l'lu dell'origine TP.

luw_id.fqla_name

Nome completo dell'LU per il TP di origine. Il nome viene restituito come stringa EBCDIC a 17 byte, costituita da NETID, un punto e il nome LU. Se la lunghezza del nome è inferiore a 17 byte, i numeri di istanza e sequenza seguono immediatamente. Si noti che a causa di questo motivo non è consigliabile usare i campi della struttura luw_id_overlay per accedere a tali valori. Sono disponibili solo per la compatibilità.

luw_id.instance

Stringa a 6 byte generata in modo univoco dall'LU per il TP di origine.

luw_id.sequence

Numero a 2 byte che indica il segmento di unità di lavoro. Questa opzione è sempre impostata su 1, se il punto di sincronizzazione non è supportato.

Se la lunghezza prot_luw_id è minore di 26 byte, viene riempita a destra con spazi EBCDIC.

pwd
Parametro fornito. Contiene la password del user_id dell'avvio tp nella richiesta di allocazione. La password viene fornita come stringa EBCDIC a 10 byte, riempita a destra con spazi EBCDIC.

Codici restituiti

AP_OK
Codice restituito primario; il verbo eseguito correttamente.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_BAD_TP_ID

Codice restituito secondario; il valore di tp_id non corrisponde a un identificatore TP assegnato da APPC.

AP_COMM_SUBSYSTEM_ABENDED
Codice restituito primario; indica una delle condizioni seguenti:

  • Il nodo usato da questa conversazione ha rilevato un ABEND.

  • La connessione tra il tp e il nodo pu 2.1 è stata interrotta (errore LAN).

  • SnaBase nel computer TP ha rilevato un ABEND.

    L'amministratore di sistema deve esaminare il log degli errori per determinare il motivo di ABEND.

    AP_COMM_SUBSYSTEM_NOT_LOADED
    Codice restituito primario; Impossibile caricare o terminare un componente obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva essere eseguita. Contattare l'amministratore di sistema per un'azione correttiva.

    AP_INVALID_VERB_SEGMENT
    Codice restituito primario; VCB esteso oltre la fine del segmento di dati.

    AP_STACK_TOO_SMALL
    Codice restituito primario; le dimensioni dello stack dell'applicazione sono troppo piccole per eseguire il verbo. Aumentare le dimensioni dello stack dell'applicazione.

    AP_TP_BUSY
    Codice restituito primario; il TP locale ha rilasciato una chiamata all'APPC mentre APPC stava elaborando un'altra chiamata per lo stesso TP. Ciò può verificarsi se il TP locale ha più thread e più thread eseguono chiamate APPC usando la stessa tp_id.

    AP_UNEXPECTED_DOS_ERROR
    Codice restituito primario; il sistema operativo ha restituito un errore all'APPC durante l'elaborazione di una chiamata APPC dal TP locale. Il codice restituito dal sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio di byte Intel. Se il problema persiste, consultare l'amministratore di sistema.

Commenti

Questo verbo si riferisce al TP anziché a una conversazione specifica, in modo che il TP possa emettere il verbo in qualsiasi stato. Non esiste alcuna modifica dello stato.

Il membro luw_id contiene campi per fqla_name_len (lunghezza del nome LU completo dell'lu che ha origine il TP), fqla_name (il nome completo dell'istanza di LU che ha origine il TP), l'istanza (generata in modo univoco dall'LU che ha origine il TP) e la sequenza (sempre impostata su 1 e indica il segmento di unità di lavoro).