Condividi tramite

GET_ATTRIBUTES

Il verbo GET_ATTRIBUTES restituisce gli attributi della conversazione.

La struttura seguente descrive il blocco di controllo verbo (VCB) utilizzato dal verbo GET_ATTRIBUTES .

Sintassi

  
struct get_attributes {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned char    reserv3;  
    unsigned char    sync_level;  
    unsigned char    mode_name[8];  
    unsigned char    net_name[8];  
    unsigned char    lu_name[8];  
    unsigned char    lu_alias[8];  
    unsigned char    plu_alias[8];  
    unsigned char    plu_un_name[8];  
    unsigned char    reserv4[2];  
    unsigned char    fqplu_name[17];  
    unsigned char    reserv5;  
    unsigned char    user_id[10];  
    unsigned long    conv_group_id;  
    unsigned char    conv_corr_len;  
    unsigned char    conv_corr[8];  
    unsigned char    reserv6[13];  
NOTE: The following fields are present when the high bit of opext is set (opext & AP_EXTD_VCB) != 0.   
    unsigned char    luw_id[26];  
    unsigned char    sess_id[8];  
};

Membri

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

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo, AP_BASIC_CONVERSATION.

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 programma di transazione locale (TP). Il valore di questo parametro viene restituito da TP_STARTED nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.

conv_id
Parametro fornito. Fornisce l'identificatore della conversazione. Il valore di questo parametro viene restituito da ALLOCATE nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.

sync_level
Parametro restituito. Specifica il livello di elaborazione della sincronizzazione per la conversazione. Questo parametro determina se i TP possono richiedere la conferma della ricezione dei dati e confermare la ricezione dei dati.

  • AP_NONE indica che l'elaborazione della conferma non verrà usata in questa conversazione.

  • AP_CONFIRM_SYNC_LEVEL indica che i TP possono usare l'elaborazione di conferma in questa conversazione.

  • AP_SYNCPT indica che i TP possono usare l'elaborazione della conferma del livello 2 del punto di sincronizzazione in questa conversazione.

    mode_name
    Parametro restituito. Specifica il nome di un set di caratteristiche di rete. Si tratta di un tipo Stringa di caratteri EBCDIC.

    net_name
    Parametro restituito. Specifica il nome della rete SNA contenente l'unità logica locale (LU) usata da questo TP. Si tratta di un tipo Stringa di caratteri EBCDIC.

    lu_name
    Parametro restituito. Fornisce il nome dell'unità lu locale.

    lu_alias
    Parametro restituito. Fornisce l'alias in base al quale l'unità lu locale è nota al tp locale. Si tratta di una stringa di caratteri ASCII.

    plu_alias
    Parametro restituito. Fornisce l'alias in base al quale il lu partner è noto al tp locale. Si tratta di una stringa di caratteri ASCII.

    plu_un_name
    Parametro restituito. Specifica il nome non interpretato dell'lu partner, ovvero il nome dell'lu partner, come definito nel punto di controllo dei servizi di sistema (SSCP). Si tratta di una stringa di caratteri EBCDIC di tipo AE. Questo parametro viene restituito solo se l'unità lu locale è dipendente.

    fqplu_name
    Parametro restituito. Fornisce il nome completo dell'unità lu partner. Si tratta di un tipo Stringa di caratteri EBCDIC. Il campo contiene il nome di rete, un punto EBCDIC e il nome partner-LU.

    user_id
    Parametro restituito. Specifica l'identificatore utente inviato dal tp di richiamo tramite ALLOCATE per accedere al tp richiamato (se applicabile). Si tratta di una stringa di caratteri EBCDIC di tipo AE. Il campo contiene l'identificatore utente se le condizioni seguenti sono vere:

  • Il tp richiamato richiede la sicurezza della conversazione.

  • GET_ATTRIBUTES è stato emesso dal TP richiamato.

    In caso contrario, il campo contiene spazi.

    conv_group_id
    Parametro restituito. Specifica l'identificatore del gruppo di conversazioni per la sessione a cui è stata allocata la conversazione. Viene restituito anche in ALLOCATE e RECEIVE_ALLOCATE.

    conv_corr_len
    Parametro restituito. Specifica la lunghezza dell'identificatore del correlatore di conversazione restituito.

    conv_corr
    Parametro restituito. Specifica l'identificatore del correlatore di conversazione (se presente) assegnato dall'unità lu di origine per identificare la conversazione, che è univoca per la coppia lu di origine/partner. Viene inviato dall'unità lu di origine nella richiesta di allocazione.

Annotazioni

I campi seguenti sono presenti quando il bit massimo di opext è impostato (opext & AP_EXTD_VCB) != 0.Questi campi sono presenti solo quando si usa il supporto del livello 2 del punto di sincronizzazione.

luw_id
Identificatore logico unità di lavoro.

sess_id
Identificatore di sessione.

Codici di ritorno

AP_OK
Codice restituito primario; verbo eseguito correttamente.

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

AP_BAD_CONV_ID

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

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).

  • La SnaBase nel computer del TP ha incontrato un ABEND.

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

    AP_CONVERSATION_TYPE_MIXED
    Codice restituito primario; il TP ha rilasciato verbi di conversazione di base e mappati. In una singola conversazione è possibile emettere un solo tipo.

    AP_INVALID_VERB_SEGMENT
    Codice restituito primario; VCB è stato 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_CONV_BUSY
    Codice restituito primario; può essere presente un solo verbo di conversazione in sospeso alla volta in qualsiasi conversazione. Ciò può verificarsi se il tp locale ha più thread e più thread eseguono chiamate APPC usando lo stesso conv_id.

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

Osservazioni:

La conversazione può essere in qualsiasi stato tranne RESET quando il tp emette questo verbo.

Non viene apportata alcuna modifica allo stato.

  • Last updated on