ObjectString (MQCHARV)

Questo è il nome oggetto lungo da utilizzare.

Il ObjectString 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.

La lunghezza massima di ObjectString è 10240.

Se ObjectString non viene specificato correttamente, in base alla descrizione di come utilizzare la struttura MQCHARV o se supera la lunghezza massima, la chiamata ha esito negativo con codice di errore MQRC_OBJECT_STRING_ERROR.

Questo è un campo di immissione. I valori iniziali dei campi in questa struttura sono gli stessi della struttura MQCHARV.

Se sono presenti caratteri jolly in ObjectString , l'interpretazione di tali caratteri jolly può essere controllata utilizzando le opzioni dei caratteri jolly specificate nel campo Opzioni di MQSD.

Al ritorno da una chiamata MQSUB utilizzando l'opzione MQSO_RESUME, questo campo non viene modificato. Il nome completo dell'argomento utilizzato viene restituito nel campo ResObjectString se viene fornito un buffer.

Se si modifica una sottoscrizione esistente utilizzando l'opzione MQSO_ALTER, il nome esteso dell'oggetto argomento sottoscritto non può essere modificato. Questo campo e il campo ObjectName possono essere omessi. Se vengono forniti, devono essere risolti con lo stesso nome argomento completo oppure la chiamata ha esito negativo con MQRC_TOPIC_NOT_ALTERABLE.