Limites de Política

É possível usar regras de política para definir diversos tipos diferentes de limites. Quando diversas regras de política com o mesmo limite forem implementadas, a ordem na qual as regras serão acionadas será regras de ação de mensagem primeiro, em seguida, regras de ação de evento e, por último, regras de ação de encerramento anormal.

Detalhes dos Tipos de Regras Suportados

Tabela 1. Detalhes dos Tipos de Regras Suportados
Tipo de Regra  1  Item de Regra  2  Operador  3  Unidade  4  Valor  5 

Solicitação do Banco de Dados

Comando SQL

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Solicitação de Arquivo

Comando Delete
Comando Read
Comando Read next
Comando Read previous
Comando Read update
Comando Rewrite
Comando Start browse
Comando Write

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Esses intervalos de valor para solicitações ou solicitações de milhar aplicam-se a todos os itens de regra de política de solicitação de arquivo.

Solicitação de Programa

Comando LINK

Nota: Os comandos INVOKE APPLICATION também são incluídos na contagem, mas não são um item de política separado.

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Iniciar pedido

Comando START

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Armazenamento

Armazenamento de tarefas de 24 bits
Armazenamento compartilhado de 24 bits

Armazenamento de tarefas de 31 bits
Armazenamento compartilhado de 31 bits

Armazenamento de tarefas de 64 bits
Armazenamento compartilhado de 64 bits

Maior Que

B
bytes
K
kilobytes
M
megabytes
G
gigabytes

Itens de regras de 24 bits:

B
0 - 16777215
K
0 - 16383
M
0 - 15
G
0

Itens de regras de 31 bits:

B
0 - 2147483647
K
0 - 2097151
M
0 - 2047
G
0 - 1

Itens de regras de 64 bits:

B
0 – 4294967295
K
0 – 4294967295
M
0 – 4294967295
G
0 – 4294967295

Solicitação de armazenamento

Solicitação de armazenamento de tarefas de 24 bits
Solicitação de armazenamento compartilhado de 24 bits

Solicitação de armazenamento de tarefas de 31 bits
Solicitação de armazenamento compartilhado de 31 bits

Solicitação de armazenamento de tarefas de 64 bits
Solicitação de armazenamento compartilhado de 64 bits

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Esses intervalos de valor para solicitações ou solicitações de milhar aplicam-se a todos os itens de regra de política de solicitação de armazenamento.

Pedido de sincronização

Comando SYNCPOINT

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Solicitação de Fila de TD

Comando READQ TD
Comando WRITEQ TD

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Esses intervalos de valor para solicitações ou solicitações de milhar aplicam-se a todos os itens de regra de política de solicitação de Fila TD.

Tempo

Tempo de CPU
Tempo decorrido

Maior Que

O
microssegundos
M
milissegundos
S
segundos
O
0 – 4294967295
M
0 - 86400000
S
0 - 86400 (um valor de 86400 é igual a 24 horas)

Bytes de Fila TS

Comando WRITEQ TS
Comando WRITEQ TS auxiliary
Comando WRITEQ TS main

Nota:
  • O item de política WRITEQ é usado para configurar um limite para a quantia de dados gravados em todas as TSQs combinadas. Os outros itens de política são usados para configurar um limite para um tipo específico de TSQ.
  • Os dados gravados pelas solicitações WRITE e REWRITE contam no total e as solicitações REWRITE são tratadas como operações WRITE, em que a contagem é incrementada pelo tamanho total de REWRITE e não pelo delta entre o WRITE original e REWRITE.
  • Os dados serão contados apenas se WRITEQ for executado com êxito.

Maior Que

B
bytes
K
kilobytes
M
megabytes
G
gigabytes
B
0 – 4294967295
K
0 – 4294967295
M
0 – 4294967295
G
0 – 4294967295

Todos os itens de regra de política de bytes de Fila TS têm os mesmos intervalos de valor.

Solicitação de fila de TS

Comando READQ TS
Comando WRITEQ TS
Comando WRITEQ TS auxiliary
Comando WRITEQ TS main

Nota: Os itens de política READQ e WRITEQ são usados para configurar um limite para o número total de solicitações READ ou WRITE para os TSQs auxiliar e principal combinados. Os outros itens de política WRITEQ são usados para configurar um limite para o número de solicitações WRITE para um tipo específico de TSQ.

Maior Que

""
solicitações
K
solicitações de milhar
""
0 – 4294967295
K
0 – 4294967

Esses intervalos de valor para solicitações ou solicitações de milhar aplicam-se a todos os itens de regra de política de solicitação de Fila TS.

Nota: Ao selecionar uma unidade e especificar um valor para o limite em sua regra de política, observe que a granularidade diminui conforme o tamanho da unidade aumenta. No entanto, se você perceber que não consegue especificar um valor suficientemente alto na unidade inferior, você pode conseguir especificar um valor apropriado usando uma unidade mais alta (maior). Por exemplo, se estiver criando uma regra de política de tipo de armazenamento e desejar definir um limite para armazenamento compartilhado de 64 bits maior que 4294967295 bytes, você não poderá usar "B" (Bytes) como sua unidade, mas poderá conseguir definir seu limite usando "K" (Kilobytes) como sua unidade e inserindo um valor de Kilobyte apropriado no campo Valor no assistente de Política.
Importante: É possível usar dados de monitoramento do CICS para definir um limite de política, mas esteja ciente de que o número de solicitações que são contadas pelo monitoramento do CICS e as solicitações que são contadas pela política do CICS podem ser diferentes. Isso ocorre porque a política conta apenas solicitações EXEC CICS API, enquanto que o monitoramento também inclui todas as solicitações internas. Portanto, todas as solicitações que não passam pela camada EXEC CICS são contadas pelo monitoramento do CICS, mas não são incluídas na contagem de política. Para usar a política para contar solicitações WRITEQ TD como um exemplo, se uma tarefa do usuário emitir uma solicitação EXEC CICS SPI para alterar o status de um recurso CICS, a mensagem DFHAP1900 será gravada no CADS da fila de dados temporários; essa solicitação é contada nos dados de monitoramento do CICS, mas não é incluída na contagem de política.

Exemplos

Este exemplo lista o XML para uma política de armazenamento e de solicitação de arquivo. A política emite a mensagem DFHMP3001 quando uma tarefa aloca mais de 1024 bytes de armazenamento de tarefas de 24 bits, ou quando uma tarefa executa mais de 50 leituras de arquivos.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Example platform policy to monitor task storage and file read counts</description>
   <userTag>exmp_1</userTag> thru <userTag>exmp_3</userTag>
   <rule type="storage" 1 > 
      <name>TooMuch24BitStorage</name> 
      <description>Issue DFHMP3001 msg when a task allocate more than 1024 bytes of 24 bit task storage</description>      
      <storageUsedCondition item="task24" 2  operator="GT" 3  value="1" 5  unit="K" 4 />      
      <action>
         <message/>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>TooManyReads</name> 
      <description>Issue DFHMP3001 msg when a task does more than 50 reads</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="50" 5  unit="" 4 />
      <action>
         <message/>  
      </action> 
   </rule> 
</policy:policy>
Este exemplo lista o XML para uma política de solicitação de arquivo que encerra uma tarefa de forma anormal. A política encerra a tarefa de forma anormal com o código de encerramento anormal padrão AMPB, se a tarefa executar mais de 10000 leituras de arquivos, ou encerra a tarefa de forma anormal com o código de encerramento anormal especificado pelo usuário CFI1, se a tarefa executar mais de 5000 gravações de arquivos. Juntamente com o encerramento anormal, é emitida a mensagem DFHMP3002.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Policy to monitor the number of file reads</description>
   <userTag>fcpol_1</userTag> 
   <rule type="filerequest" 1 > 
      <name>File_Reads</name> 
      <description>Abend the task if the file read limit exceeded</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="10" 5  unit="K" 4 />      
      <action>
         <abend/>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>File Write</name> 
      <description>Abend the task with specified abend code CFI1 if the file write limit exceeded</description>      
      <fileRequestCondition item="write" 2  operator="GT" 3  value="5" 5  unit="K" 4 />
      <action>
         <abend abendCode="CFI1"/>  
      </action> 
   </rule> 
</policy:policy>
Este exemplo lista o XML para uma política de solicitação de arquivo que emite eventos. A política emite um evento para um adaptador de eventos chamado adapterB, se a tarefa executar mais de 500 gravações de arquivos, e emite um evento para um conjunto de adaptadores de eventos chamado adaSetA, se a tarefa executar mais de 100 leituras de arquivos.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Policy to monitor the number of file reads</description>
   <userTag>fcpol_1</userTag> 
   <rule type="filerequest" 1 > 
      <name>File Write</name> 
      <description>The file write limitation policy</description>      
      <fileRequestCondition item="write" 2  operator="GT" 3  value="500" 5  unit="" 4 />      
      <action>
         <event>  
            <eventAdapterName>adapterB</eventAdapterName> 
         </event>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>File_Reads</name> 
      <description>File read limitation policy</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="100" 5  unit="" 4 />
      <action>
         <event>  
            <eventAdapterSetName>adaSetA</eventAdapterSetName> 
         </event>  
      </action> 
   </rule> 
</policy:policy>
Para obter informações adicionais sobre como os detalhes de tipos de regras mostrados em Tabela 1 são mapeados para parâmetros e valores XML, consulte Nome de Elemento e Valores de Atributos de XML de Política.