ObjectName (MQCHAR48)

È il nome dell'oggetto argomento come definito sul gestore code locale.

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.

ObjectName viene utilizzato per formare il nome completo dell'argomento.

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.

Se non è possibile trovare l'oggetto identificato dal campo ObjectName , la chiamata ha esito negativo con codice motivo MQRC_UNKNOWN_OBJECT_NAME anche se è presente una stringa specificata in ObjectString.

Al ritorno da una chiamata MQSUB utilizzando l'opzione MQSO_RESUME, questo campo non viene modificato.

La lunghezza di questo campo è fornita da MQ_TOPIC_NAME_LENGTH. Il valore iniziale di questo campo è la stringa nulla in C e 48 caratteri vuoti in altri linguaggi di programmazione.

Se si altera una sottoscrizione esistente utilizzando l'opzione MQSO_ALTER, il nome dell'oggetto argomento sottoscritto non può essere modificato. Questo campo e il campo ObjectString possono essere omessi. Se vengono forniti, devono risolversi nello stesso nome completo dell'argomento. In caso contrario, la chiamata ha esito negativo con MQRC_TOPIC_NOT_ALTERABLE.