Comandi script (MQSC)

I comandi MQSC forniscono un metodo uniforme di emissione di comandi leggibili su piattaforme IBM® MQ . Per informazioni sui comandi PCF ( programmable command format ), consultare Introduzione a Programmable Command Formats.

Il formato generale dei comandi viene mostrato in Comandi MQSC.

È necessario osservare le seguenti regole quando si utilizzano i comandi MQSC:
  • Ogni comando inizia con un parametro primario (un verbo) e questo è seguito da un parametro secondario (un nome). Questo è seguito dal nome o dal nome generico dell'oggetto (tra parentesi) se ne esiste uno, che è presente nella maggior parte dei comandi. Successivamente, i parametri possono di solito verificarsi in qualsiasi ordine; se un parametro ha un valore corrispondente, il valore deve essere immediatamente successivo al parametro a cui si riferisce.
    [z/OS]Nota: su z/OS®, il parametro secondario non deve essere il secondo.
  • Parole chiave, parentesi e valori possono essere separati da qualsiasi numero di spazi e virgole. Una virgola mostrata nei diagrammi di sintassi può essere sempre sostituita da uno o più spazi vuoti. Ogni parametro deve essere preceduto da almeno uno spazio vuoto (dopo il parametro primario) [z/OS]tranne che su z/OS .
  • Qualsiasi numero di spazi vuoti può verificarsi all'inizio o alla fine del comando e tra parametri, punteggiatura e valori. Ad esempio, il seguente comando è valido:
    ALTER QLOCAL ('Account' )      TRIGDPTH ( 1)
    Gli spazi vuoti all'interno di una coppia di apici sono significativi.
  • Le virgole aggiuntive possono essere visualizzate in qualsiasi punto in cui sono consentiti spazi e vengono trattate come se fossero spazi vuoti (a meno che, naturalmente, non siano all'interno di stringhe racchiuse tra virgolette).
  • Non sono consentiti parametri ripetuti. La ripetizione di un parametro con la sua versione "NO", come in REPLACE NOREPLACE, non è consentita.
  • Stringhe che contengono spazi, caratteri minuscoli o caratteri speciali diversi da:
    • Punto (.)
    • Barra (/)
    • Trattino basso (_)
    • Segno percentuale (%)
    deve essere racchiuso tra virgolette singole, a meno che non siano:
    • [z/OS]Emesso dai pannelli di controllo e dalle operazioni IBM MQ for z/OS
    • Valori generici che terminano con un asterisco [IBMi](su IBM i devono essere racchiusi tra virgolette singole)
    • Un singolo asterisco (ad esempio, TRACE (*)) [IBMi](su IBM i devono essere racchiusi tra virgolette singole)
    • Una specifica di intervallo contenente due punti (ad esempio, CLASS (01:03))

    Se la stringa contiene una virgoletta singola, la virgoletta singola è rappresentata da due virgolette singole. I caratteri minuscoli non contenuti tra virgolette vengono ripiegati in maiuscolo.

  • Su piattaforme diverse da z/OS, una stringa che non contiene caratteri (vale a dire, due virgolette singole senza spazi in mezzo) viene interpretata come uno spazio vuoto racchiuso tra virgolette singole, vale a dire, interpretata come (''). L'eccezione è se l'attributo utilizzato è uno dei seguenti:
    • TOPICSTR
    • SUB
    • USERDATA
    • SELECTOR
    due virgolette singole senza spazi vengono interpretate come una stringa di lunghezza zero.

    [z/OS]Su z/OS, se si desidera uno spazio vuoto racchiuso tra virgolette singole, è necessario immetterlo come tale (''). Una stringa che non contiene caratteri ('') è uguale all'immissione di ().

  • In v7.0, tutti gli spazi vuoti finali in tali attributi stringa che si basano sui tipi MQCHARV, come SELECTOR, dati utente secondari, vengono trattati come significativi, il che significa che 'abc' non è uguale a 'abc'.
  • Una parentesi di apertura seguita da una parentesi di chiusura, senza alcuna informazione significativa nel mezzo, ad esempio
    NAME ( )
    non è valido tranne dove specificatamente indicato.
  • Le parole chiave non sono sensibili alle maiuscole: AltER, alter e ALTER sono tutte accettabili. Tutto ciò che non è contenuto tra virgolette viene ripiegato in maiuscolo.
  • I sinonimi sono definiti per alcuni parametri. Ad esempio, DEF è sempre un sinonimo di DEFINE, quindi DEF QLOCAL è valido. I sinonimi non sono, tuttavia, solo stringhe minime; DEFI non è un sinonimo valido per DEFINE.
    Nota: non esiste alcun sinonimo per il parametro DELETE. Ciò per evitare l'eliminazione accidentale di oggetti quando si utilizza DEF, il sinonimo di DEFINE.

Per una panoramica sull'utilizzo dei comandi MQSC per la gestione di IBM MQ, consultare Esecuzione delle attività di gestione locali utilizzando i comandi MQSC.

I comandi MQSC utilizzano determinati caratteri speciali per avere determinati significati. Per ulteriori informazioni su questi caratteri speciali e su come utilizzarli, consultare Caratteri con significati speciali.

Per informazioni su come creare script utilizzando i comandi MQSC, consultare Creazione di script di comando.

Per una spiegazione dei simboli nella colonna z/OS , consultare Utilizzo dei comandi su z/OS.

Per un elenco completo dei comandi MQSC, consultare Comandi MQSC.