ObjectName (MQCHAR48)

Questo è il nome locale dell'oggetto come definito sul gestore code identificato da ObjectQMgrName. Il nome può contenere i seguenti caratteri:
  • Caratteri alfabetici maiuscoli (da A a Z)
  • Caratteri alfabetici minuscoli (da a a z)
  • Cifre numeriche (da 0 a 9)
  • Punto (.), barra (/), sottolineatura (_), percentuale (%)
Il nome non deve contenere spazi iniziali o intermedi, ma può contenere spazi finali. Utilizzare un carattere null per indicare la fine dei dati significativi nel nome; il valore null e i caratteri che lo seguono vengono trattati come spazi vuoti. Le seguenti limitazioni si applicano agli ambienti indicati:
  • Sui sistemi che utilizzano EBCDIC Katakana, non è possibile utilizzare caratteri minuscoli.
  • Attivo z/OS®:
    • Evitare i nomi che iniziano o terminano con un carattere di sottolineatura; non possono essere elaborati dalle operazioni e dai pannelli di controllo.
    • Il carattere percentuale ha un significato speciale per RACF®. Se RACF viene utilizzato come gestore della sicurezza esterno, i nomi non devono contenere la percentuale. In tal caso, tali nomi non vengono inclusi nei controlli di sicurezza quando vengono utilizzati i profili generici RACF .
  • Su IBM® i, i nomi contenenti caratteri minuscoli, barra o percentuale, devono essere racchiusi tra virgolette quando vengono specificati nei comandi. Questi apici non devono essere specificati per i nomi che si verificano come campi nelle strutture o come parametri nelle chiamate.

Il nome completo dell'argomento può essere creato da due campi differenti: ObjectName e ObjectString. Per i dettagli su come vengono utilizzati questi due campi, consultare Utilizzo di stringhe di argomenti.

I seguenti punti si applicano ai tipi di oggetto indicati:
  • Se ObjectName è il nome di una coda modello, il gestore code crea una coda dinamica con gli attributi della coda modello e restituisce nel campo ObjectName il nome della coda creata. Una coda modello può essere specificata solo sulla chiamata MQOPEN; una coda modello non è valida sulla chiamata MQPUT1 .
  • Se ObjectName è il nome di una coda alias con TARGTYPE (TOPIC), un controllo di sicurezza viene eseguito prima sulla coda alias denominata; ciò è normale quando vengono utilizzate le code alias. Quando il controllo di sicurezza viene completato correttamente, la chiamata MQOPEN continua e si comporta come una chiamata MQOPEN su un MQOT_TOPIC; ciò include l'esecuzione di un controllo di sicurezza rispetto all'oggetto argomento di gestione.
  • Se ObjectName e ObjectQMgrName identificano una coda condivisa appartenente al gruppo di condivisione code a cui appartiene il gestore code locale, non deve essere presente anche una definizione di coda con lo stesso nome sul gestore code locale. Se esiste una definizione di questo tipo (una coda locale, una coda alias, una coda remota o una coda modello), la chiamata ha esito negativo con codice motivo MQRC_OBJECT_NOT_UNIQUE.
  • Se l'oggetto che si sta aprendo è un elenco di distribuzione (ovvero, RecsPresent è presente e maggiore di zero), ObjectName deve essere vuoto o la stringa null. Se questa condizione non viene soddisfatta, la chiamata ha esito negativo con codice motivo MQRC_OBJECT_NAME_ERROR.
  • Se ObjectType è MQOT_Q_MGR, si applicano le regole speciali; in questo caso, il nome deve essere completamente vuoto fino al primo carattere null o alla fine del campo.

Questo è un campo di input / output per la chiamata MQOPEN quando ObjectName è il nome di una coda modello e un campo di solo input in tutti gli altri casi. La lunghezza di questo campo è fornita da MQ_Q_NAME_LENGTH. Il valore iniziale di questo campo è la stringa nulla in C e 48 caratteri vuoti in altri linguaggi di programmazione.