ACL ManPt v7 - Manual - Completo

ACL
Verso
7
Manual de Referncia
ACL Services Ltd.

1550 Alberni Street
Vancouver, BC, Canada V6G 1A5
Tel: +1-604-669-4225 Fax: +1-604-669-3557
E-mail: info@acl.com Web: www.acl.com
ACL Europe S.A.

Ringlaan 39 bus 3
1853 Strombeek-Bever, Belgium
Tel: +32-2-642-22-90 Fax: +32-2-642-22-91
E-mail: info_europe@acl.com Web: www.acl.com
AWDP107087
ACL
50 Kallang Avenue
#07-05 Noel Corporate Building
Singapore 339505
Tel: +65-299-3350 Fax: +65-299-5110
E-mail: info_asia@acl.com Web: www.acl.com
para Windows
ACL Services (Singapore) Pte. Ltd.
Manual de Referncia
ACL para Windows
Verso
Manual de Referncia
ACL para Windows
Verso
Copyright 2002 ACL Services Ltd.

Todos os direitos reservados.
Nenhuma parte desta publicao pode ser reproduzida, armazenada em sistema de busca ou transmitida
sob qualquer forma ou por qualquer meio (fotocpia, eletrnico, mecnico, gravao ou outro), sem a
permisso por escrito da editora, exceto por crticos, que podero citar trechos curtos em resenhas.
Este manual poder conter informaes datadas. O uso deste material dever ser feito compreendendo-se
que este manual pode no conter todas as informaes, ou as informaes mais atuais relevantes para a
situao ou aplicao pretendida. Os servios de suporte e atualizao esto disponveis na ACL, atravs de
um contrato impresso separado.
Publicado em fevereiro de 2002 por:

ACL Services Ltd.
1550 Alberni Street
Vancouver, BC
Canada V6G 1A5
Fone: 1-604-669-4225
Fax: 1-604-669-3557
E-mail: info@acl.com
Web: www.acl.com
Impresso no Canad 10 9 8 7 6 5 4 3 2 1
ACL e Audit Command Language so marcas registradas da ACL ou de uma de suas subsidirias ou de
seus licenciadores. Microsoft, Windows, o logotipo do Windows, e Windows NT so marcas registradas da
Microsoft Corporation. SAP uma marca registrada da SAP AG. Outras marcas ou produtos
mencionados no software, ou associados a ele, so marcas comerciais ou marcas registradas de seus
respectivos proprietrios, devendo ser tratadas como tal.
O uso de um termo neste manual no deve ser interpretado como se afetasse a validade de qualquer marca
registrada ou de servio.
iii
ndice
Sobre este manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Captulo 1: Tipos de campo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Categorias de dados .................................................................................. 5
Dados de caractere ............................................................................ 5
Dados numricos .............................................................................. 5
Dados lgicos .................................................................................... 5
Dados de data .................................................................................... 5
Tipos de campos do ACL ......................................................................... 6
Dados de origem e tipos de campo do ACL ............................................ 7
ACCPAC ................................................................................................... 8
ACL ........................................................................................................... 8
ASCII ........................................................................................................ 8
BASIC ....................................................................................................... 9
Binary (Binrio) ........................................................................................ 9
Custom (Personalizado) ........................................................................ 10
Date (Data) ............................................................................................. 11
Datas em branco ou invlidas ......................................................... 11
Ano de dois dgitos ......................................................................... 11
Datas seriais ..................................................................................... 12
Datas em campos numricos comprimidos ................................... 12
Formatos de data ............................................................................. 13
Convenes de formatao de data ................................................ 14
Sintaxe do modo de comando ........................................................ 14
EBCDIC .................................................................................................. 15
Float (Ponto flutuante) ........................................................................... 15
Halfbyte (Meio byte) .............................................................................. 15
IBMfloat (Ponto flutuante da IBM) ....................................................... 16
Logical (Lgico) ...................................................................................... 16
Micro ...................................................................................................... 17
Numeric (Numrico) ............................................................................. 17
Packed (Compactado) ........................................................................... 18
Datas em campos numricos compactados ................................... 18
Cdigos de sculo em campos de data compactados .................... 18
PCASCII ................................................................................................. 20
iv
ndice
Print (Imprimir) ....................................................................................

Unisys .....................................................................................................
Unsigned (Sem sinal) .............................................................................
VAXfloat ................................................................................................
Zoned (Zonado) ....................................................................................
20
21
22
22
22
Captulo 2: Funes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Resumo das funes ..............................................................................
ABSOLUTE( ) ........................................................................................
AGE( ) ....................................................................................................
ALLTRIM( ) ...........................................................................................
ASCII( ) ..................................................................................................
AT( ) .......................................................................................................
BETWEEN( ) .........................................................................................
BIT( ) ......................................................................................................
BLANKS( ) .............................................................................................
BYTE( ) ..................................................................................................
CDOW( ) ...............................................................................................
CHR( ) ....................................................................................................
CLEAN( ) ...............................................................................................
CTOD( ) .................................................................................................
DATE( ) ..................................................................................................
DECIMALS( ) ........................................................................................
DIGIT( ) .................................................................................................
DOW( ) ..................................................................................................
EBCDIC( ) .............................................................................................
EFFECTIVE( ) .......................................................................................
EXCLUDE( ) ..........................................................................................
EXPONENT( ) .......................................................................................
FILESIZE( ) ............................................................................................
FIND( ) ...................................................................................................
FREQUENCY( ) ....................................................................................
FTYPE( ) ................................................................................................
FVANNUITY( ) .....................................................................................
FVLUMPSUM( ) ...................................................................................
HEXADECIMAL( ) ...............................................................................
INCLUDE( ) ...........................................................................................
INSERT( ) ..............................................................................................
INTEGER( ) ...........................................................................................
23
28
28
29
29
30
32
33
35
35
36
36
37
38
39
40
41
42
42
43
44
44
45
46
47
48
49
50
51
52
52
53
ndice
ISBLANK( ) ............................................................................................ 53
LAST( ) ................................................................................................... 54
LEADING( ) ........................................................................................... 55
LENGTH( ) ............................................................................................. 55
LOGARITHM( ) ..................................................................................... 56
LOWER( ) ............................................................................................... 57
LTRIM( ) ................................................................................................ 57
MAP( ) .................................................................................................... 58
MASK( ) .................................................................................................. 59
MATCH( ) .............................................................................................. 60
MAXIMUM( ) ........................................................................................ 61
MINIMUM( ) ......................................................................................... 62
MOD( ) ................................................................................................... 63
NOMINAL( ) .......................................................................................... 63
NPER( ) .................................................................................................. 64
OCCURS( ) ............................................................................................. 65
OFFSET( ) ............................................................................................... 65
PACKED( ) ............................................................................................. 66
PMT( ) .................................................................................................... 67
PROPER( ) .............................................................................................. 68
PVANNUITY( ) ..................................................................................... 68
PVLUMPSUM( ) .................................................................................... 69
RAND( ) ou RND( ) ............................................................................... 70
RATE( ) .................................................................................................. 70
RECLEN( ) .............................................................................................. 71
RECNO( ) ............................................................................................... 72
REMOVE( ) ............................................................................................ 73
REPEAT( ) .............................................................................................. 74
REPLACE( ) ........................................................................................... 74
REVERSE( ) ............................................................................................ 76
RJUSTIFY( ) ........................................................................................... 76
ROOT( ) .................................................................................................. 76
ROUND( ) .............................................................................................. 77
SHIFT( ) .................................................................................................. 77
SOUNDEX( ) .......................................................................................... 78
SOUNDSLIKE( ) .................................................................................... 79
SPLIT( ) .................................................................................................. 79
STRING( ) .............................................................................................. 80
SUBSTRING( ) ....................................................................................... 81
vi
ndice
TEST( ) ...................................................................................................
TIME( ) ..................................................................................................
TRANSFORM( ) ....................................................................................
TRIM( ) ..................................................................................................
UNSIGNED( ) ........................................................................................
UPPER( ) ................................................................................................
VALUE( ) ...............................................................................................
VERIFY( ) ..............................................................................................
ZONED( ) ..............................................................................................
ZSTAT( ) ................................................................................................
82
82
84
84
85
85
86
87
87
88
Captulo 3: Parmetros de comandos comuns . . . . . . . . . . . . . . . . . 91

All (Tudo) .............................................................................................. 91
Append (Anexar) ................................................................................... 92
As (Como) .............................................................................................. 92
Ascending (Crescente) .......................................................................... 93
Break (Quebra) ...................................................................................... 94
Descending (Decrescente) ..................................................................... 95
End of File (Fim de arquivo) ................................................................. 96
File (Arquivo) ........................................................................................ 98
File Type (Tipo de arquivo) ................................................................... 98
First (Primeiros) .................................................................................... 99
Footer (Rodap) ................................................................................... 100
Graph (Grfico) .................................................................................... 100
Header (Cabealho) .............................................................................. 101
If (Se) ..................................................................................................... 102
Key (Chave) .......................................................................................... 103
Local ...................................................................................................... 104
Name (Nome) ....................................................................................... 104
Next (Prximo) ..................................................................................... 105
Nodups (Suprimir duplicidades) ......................................................... 106
Nozeros (Branco se for zero) ................................................................ 106
Open (Abrir) ......................................................................................... 107
Page (Pgina) ........................................................................................ 107
Picture (Figura) ..................................................................................... 107
Print (Imprimir) ................................................................................... 108
Record (Registro) ................................................................................. 108
Screen (Tela) ......................................................................................... 109
Suppress (Suprimir) ............................................................................. 110
ndice
To (Para) ...............................................................................................
Use Output File (Usar arquivo de sada) .............................................
While (Enquanto) ................................................................................
Width (Largura) ...................................................................................
111
112
112
114
Captulo 4: Comandos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Accept (Aceitar) ................................................................................... 115
Caixas de dilogo criadas com Aceitar ......................................... 116
Parmetros .................................................................................... 116
Sintaxe do modo de comando ...................................................... 116
Activate (Ativar) ................................................................................... 120
Parmetros .................................................................................... 121
Age (Perodo) ....................................................................................... 123
Parmetros .................................................................................... 123
Caixa de dilogo Perodo .............................................................. 124
Assign (Atribuir) .................................................................................. 128
Parmetros .................................................................................... 129
Benford ................................................................................................. 130
Parmetros .................................................................................... 130
Entrada .......................................................................................... 131
Sada .............................................................................................. 132
Caixa de dilogo Benford .............................................................. 133
Calculate (Calcular) .............................................................................. 134
Pr-requisitos ................................................................................ 135
Parmetros .................................................................................... 135
Classify (Classificar) ............................................................................. 136
Parmetros .................................................................................... 137
Sada do comando ......................................................................... 137
Caixa de dilogo Classificar .......................................................... 138
Close (Fechar) ...................................................................................... 140
Comment (Comentrio) ...................................................................... 141
Caixa de dilogo Comentrio ....................................................... 141
vii
viii
ndice

Count (Contar) ..................................................................................... 143
Parmetros ..................................................................................... 143
Caixa de dilogo Contar ................................................................ 143
Define Field (Definir campo) ............................................................... 144
Parmetros ..................................................................................... 145
Define Relations (Definir relacionamentos) ........................................ 148
Define Report (Definir relatrio) ......................................................... 148
Delete (Excluir) ..................................................................................... 149
Parmetros ..................................................................................... 150
Dialog (Dilogo) ................................................................................... 151
Construtor de dilogos .................................................................. 152
Criar uma caixa de dilogo personalizada .................................... 153
Controles ....................................................................................... 155
Editar controles ............................................................................. 162
Excluir controles ............................................................................ 162
Editar uma caixa de dilogo personalizada .................................. 162
Display (Exibir) ..................................................................................... 165
Parmetros ..................................................................................... 165
Do Batch (Executar batch) ................................................................... 167
Parmetros ..................................................................................... 168
Caixa de dilogo Executar batch ................................................... 168
Do Report (Executar relatrio) ............................................................ 170
Dump (Descarregar) ............................................................................. 170
Parmetros ..................................................................................... 170
Caixa de dilogo Descarregar ........................................................ 172
Duplicates (Duplicidades) .................................................................... 174
Parmetros ..................................................................................... 174
Caixa de dilogo Duplicidades ...................................................... 175
Else (Seno) ........................................................................................... 175
ndice
Parmetros .................................................................................... 175

Caixa de dilogo Seno ................................................................. 175
End (Fim) ............................................................................................. 176
Evaluate (Avaliar) ................................................................................. 176
Avaliao da amostra de registro .................................................. 178
Avaliao de amostra monetria .................................................. 178
Parmetros .................................................................................... 179
Caixa de dilogo Avaliar ............................................................... 180
Export (Exportar) ................................................................................. 183
Criando arquivos do MS Excel e do MS Access ........................... 184
Exportando XML .......................................................................... 184
Utilizao de exportar com o Sistema ACL Cliente/Servidor ..... 184
Parmetros .................................................................................... 184
Caixa de dilogo Exportar ............................................................ 185
Extract (Extrair) ................................................................................... 186
Parmetros .................................................................................... 187
Caixa de dilogo Extrair ................................................................ 188
Fieldshift (Deslocar campos) ............................................................... 191
Parmetros .................................................................................... 191
Boto Deslocar campos ................................................................ 192
File history (Histrico do arquivo) ...................................................... 194
Item de menu Histrico do arquivo ............................................. 194
Find (Localizar) .................................................................................... 195
Pr-requisitos ................................................................................ 196
Gaps (Falhas) ........................................................................................ 197
Parmetros .................................................................................... 197
Caixa de dilogo Falhas ................................................................ 197
Group (Grupo) ..................................................................................... 198
Parmetros .................................................................................... 199
Caixa de dilogo Grupo ................................................................ 199
ix
ndice
Grupos simples .............................................................................. 200

Grupos condicionais ..................................................................... 200
Grupos aninhados ......................................................................... 202
Variveis em grupos ...................................................................... 202
Help (Ajuda) ......................................................................................... 203
Boto Ajuda ................................................................................... 203
Histogram (Histograma) ...................................................................... 203
Parmetros ..................................................................................... 204
Caixa de dilogo Histograma ........................................................ 206
If (Se) ..................................................................................................... 210
Import (Importar) ................................................................................ 210
Importando dados externos .......................................................... 211
Index (ndice) ....................................................................................... 211
Indexao versus Ordenao ........................................................ 212
Seqncia de ordenao ................................................................ 212
Ativar ndices ................................................................................. 213
Dicas de indexao ........................................................................ 213
Filtros e condies ......................................................................... 213
Parmetros ..................................................................................... 214
Caixa de dilogo ndice ................................................................. 214
Join (Associar) ...................................................................................... 218
Associar versus Relacionamentos ................................................. 218
Opes de sada da associao ...................................................... 219
Nomes dos campos do arquivo de sada ....................................... 221
Localizao dos arquivos de origem ............................................. 221
Preparando os campos-chave ....................................................... 221
Parmetros ..................................................................................... 222
Caixa de dilogo Associar ............................................................. 224
List (Listar) ............................................................................................ 227
Parmetros ..................................................................................... 228
Locate (Buscar) ..................................................................................... 230
Parmetros ..................................................................................... 231
ndice

Loop ...................................................................................................... 232
Parmetros .................................................................................... 232
Caixa de dilogo Loop .................................................................. 232
Merge (Mesclar) ................................................................................... 234
Pr-requisitos ................................................................................ 234
Parmetros .................................................................................... 235
Caixa de dilogo Mesclar .............................................................. 235
Notify (Notificar) ................................................................................. 237
Parmetros .................................................................................... 237
Caixa de dilogo Notificar ............................................................ 238
Open (Abrir) ........................................................................................ 240
Parmetros .................................................................................... 240
Password (Senha) ................................................................................. 243
Pause (Pausa) ........................................................................................ 244
Parmetros .................................................................................... 244
Profile (Perfil) ....................................................................................... 245
Parmetros .................................................................................... 245
Caixa de dilogo Perfil .................................................................. 246
Quit (Sair) ............................................................................................. 248
Random (Aleatrio) ............................................................................. 249
Parmetros .................................................................................... 249
Caixa de dilogo Aleatrio ........................................................... 250
Refresh (Atualizar) ............................................................................... 252
Parmetros .................................................................................... 252
Boto Atualizar a partir do arquivo fonte .................................... 253
Relations (Relacionamentos) ............................................................... 253
Arquivos pai e filho ....................................................................... 254
Pr-requisitos para o relacionamento de arquivos ...................... 254
xi
xii
ndice
Escolha dos campos-chave ............................................................ 255

Normalizar campos-chave ............................................................ 255
Escolher arquivos relacionados .................................................... 256
Indexar arquivos relacionados por seus campos-chave ............... 256
Planejar relacionamentos entre arquivos de dados ...................... 257
Parmetros ..................................................................................... 259
Caixa de dilogo Relacionamentos ............................................... 261
Relacionamento de arquivos ......................................................... 261
Acessar campos relacionados ........................................................ 263
Adicionar campos exibio ........................................................ 265
Excluir relacionamentos ................................................................ 266
Definir relacionamentos temporrios .......................................... 268
Rename (Renomear) ............................................................................ 269
Pr-requisitos ................................................................................ 270
Parmetros ..................................................................................... 270
Report (Relatrio) ................................................................................ 272
Personalizar relatrios ................................................................... 272
Pr-requisitos ................................................................................ 273
Parmetros ..................................................................................... 273
Caixa de dilogo Relatrio ............................................................ 274
Sample (Amostra) ................................................................................. 278
Tendncia de amostragem ............................................................ 278
Tipo de amostra ............................................................................. 279
Amostragem por intervalo fixo ..................................................... 280
Amostragem por clula ................................................................. 280
Amostragem aleatria ................................................................... 280
Parmetros ..................................................................................... 283
Caixa de dilogo Amostra ............................................................. 286
Save (Salvar) .......................................................................................... 290
Parmetros ..................................................................................... 290
Search (Pesquisar) ................................................................................ 291
Parmetros ..................................................................................... 291
Caixa de dilogo Pesquisar ............................................................ 293
ndice
Seek (Encontrar) .................................................................................. 297

Pr-requisitos ................................................................................ 297
Sequence (Seqncia) .......................................................................... 298
Parmetros .................................................................................... 299
Caixa de dilogo Seqncia .......................................................... 300
Set (Definir) .......................................................................................... 303
Equivalentes de preferncias ........................................................ 304
Sem equivalentes de preferncias ................................................. 305
Size (Tamanho) .................................................................................... 309
Tamanhos da Amostra .................................................................. 310
Parmetros .................................................................................... 311
Caixa de dilogo Tamanho ........................................................... 312
Sort (Ordenar) ...................................................................................... 317
Ordenao versus Indexao ........................................................ 317
Requisitos de espao em disco ...................................................... 319
Classificao versus Ordenao e Sumarizao ........................... 319
Parmetros .................................................................................... 319
Caixa de dilogo Ordenar ............................................................. 319
Statistics (Estatsticas) .......................................................................... 322
Parmetros .................................................................................... 322
Caixa de dilogo Estatsticas ......................................................... 323
Stratify (Estratificar) ............................................................................. 326
Parmetros .................................................................................... 327
Caixa de dilogo Estratificar ......................................................... 328
Sada do comando ......................................................................... 331
Summarize (Sumarizar) ....................................................................... 332
Pr-requisitos ................................................................................ 333
Parmetros .................................................................................... 333
Caixa de dilogo Sumarizar .......................................................... 334
Tape (Fita) ............................................................................................ 336
Parmetros .................................................................................... 337
xiii
xiv
ndice
Top (Acima) .......................................................................................... 338

Total ...................................................................................................... 338
Parmetros ..................................................................................... 339
Caixa de dilogo Total ................................................................... 339
Verify (Verificar) .................................................................................. 341
Parmetros ..................................................................................... 342
Caixa de dilogo Verificar ............................................................. 343
Apndice A: Como usar o utilitrio ACL . . . . . . . . . . . . . . . . . . . . . 347

Converter do OS/390 para Windows ................................................... 347
Mensagens de converso ............................................................... 349
Mensagens informativas ............................................................... 349
Mensagens de erro ......................................................................... 350
Mensagens de erro fatal ................................................................. 351
Uso de arquivos do OS/390 convertidos .............................................. 351
Batches ........................................................................................... 352
Arquivos de formato ..................................................................... 352
Relatrios ....................................................................................... 353
Apndice B: Trabalhar com fita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Aquisio de um sistema de unidade de fita ........................................ 355
Componentes do sistema de unidade de fita ................................ 356
Antes de iniciar ..................................................................................... 357
Como os dados so organizados na fita ............................................... 358
Data sets e marcas de arquivo ....................................................... 358
Posicionar a fita ............................................................................. 359
Alternar entre a fita e o disco ........................................................ 360
Trabalhar com arquivos de fita ............................................................. 361
Criar uma definio de arquivo de entrada .................................. 361
Processar arquivos da fita .............................................................. 361
Resolver problemas de fita .................................................................... 362
Apndice C: Glossrio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Sobre este manual

Este manual apresenta informaes detalhadas sobre:
Tipos de campo do ACL
Funes do ACL
Comandos do ACL
O Manual de Referncia do ACL para Windows oferecido para usurios licenciados do

ACL. Para adquirir cpias adicionais, visite o site www.acl.com.
Publicaes relacionadas
Guia do usurio do ACL para Windows
O Guia do Usurio do ACL para Windows ir ajudar no uso inicial do
ACL para Windows Verso 7. Ele mostra como:
Ler ou importar dados de arquivos de dados de fonte externa
Visualizar, analisar e reportar dados
Automatizar rotinas analticas personalizadas
Usar o ACL para Windows Verso 7 juntamente com o ACL for OS/390 em um
ambiente cliente/servidor
O Guia do Usurio do ACL para Windows oferecido a usurios licenciados do ACL.

Para adquirir cpias adicionais, visite o site www.acl.com.
Livro de trabalho do ACL para Windows

O livro de trabalho do ACL para Windows (Livro de Trabalho do ACL para Windows)
um guia de auto-estudo. Mesmo que voc seja iniciante na rea de anlise de dados, ou
j possua alguma experincia com o ACL, este guia ir ajud-lo a dominar o
ACL para Windows e aplic-lo a problemas do mundo real.
O livro de trabalho oferecido a usurios licenciados do ACL. Para adquirir cpias
adicionais, visite o site ACL www.acl.com.
ACL para Windows Verso 7
Convenes da sintaxe de comando

As seguintes convenes so usadas para descrever a sintaxe do modo de comando das
funes e comandos do ACL.
Espaamento simples
Indica sintaxe de comando usada na linha de comando ou em um

batch.
Itlico com
Indica itens especificados pelo usurio, como nomes de campos.
espaamento simples
Parnteses
angulados < >
Indicam parmetros ou selees de comandos opcionais.
Chaves { }
Incluem um conjunto de opes dentre as quais deve ser escolhida

uma nica.
Barras
Reticncias...
Barras verticais separam opes.

Indicam que o item anterior pode ser repetido.
Precisa de ajuda?
Recursos
Para assistncia no uso do ACL, consulte estes recursos adicionais:
Guia do Usurio do ACL para Windows
ACL para Windows Verso 7 Ajuda on-line
Livro de Trabalho do ACL para Windows
Se disponvel, o centro de suporte tcnico do ACL interno sua empresa
Caso no consiga encontrar a soluo para seu problema e se voc for um usurio com
direito a suporte, entre em contato com a ACL para obter assistncia. Antes de entrar em
contato, certifique-se de ter em mos as seguintes informaes:
O nmero de srie do ACL. Voc encontra esse nmero no verso da caixa de seu
CD ou no ACL para Windows Verso 7. Selecione Ajuda na barra de menus e
escolha Sobre o ACL.
Tipo de hardware que voc est usando e se est conectado a uma Rede Local
(LAN).
Uma descrio da ocorrncia e o que voc estava fazendo quando o problema
ocorreu.
A mensagem de erro, se houver, exibida pelo ACL.
Sobre este manual
Centro de suporte on-line

Caso tenha acesso Internet (World Wide Web), visite o site ACL www.acl.com e
clique em Suporte On-Line. L voc ir encontrar ferramentas e recursos teis para
aprimorar o uso do ACL.
Help desk global

As Amricas
Telefone: +1-604-669-4997
Fax: +1-604-689-4209
E-mail: support@acl.com
Europa, Oriente Mdio e frica
Telefone: +32-2-642-22-90
Fax: +32-2-642-22-91
E-mail: support_europe@acl.com
sia e Costa do Pacfico
Telefone: +65-299-3350
Fax: +65-299-5110
E-mail: support_asia@acl.com
Queremos ouvi-lo!
A ACL compromete-se com o fornecimento de produtos e servios de qualidade para
acesso, anlise e relatrios de dados. Para garantir sua satisfao contnua, aguardamos
suas sugestes de melhorias do ACL para Windows, da nossa documentao dos
usurios e da Ajuda on-line.
Envie seus comentrios para nossa equipe de gerenciamento de produtos para:
Telefone: +1-604-669-4225
Fax: +1-604-669-3557
E-mail: product_mgmt@acl.com
Captulo 1
T IPOS DE CAMPO
O ACL reconhece todos os tipos de dados das fontes mais comuns e atribui, automaticamente, um tipo de campo do ACL correspondente. Cada tipo de campo do ACL tem
uma categoria de dados correspondente.
Categorias de dados
Muitos esquemas foram desenvolvidos para representar categorias de dados com cdigo
binrio. Esses esquemas de codificao so largamente agrupados em quatro categorias:
Caractere, Numrico, Lgico e Data. No ACL, essas categorias so, algumas vezes,
representadas pelas letras C, N, L e D.
Dados de caractere
Os dados de caractere normalmente so utilizados para representar as cadeias de texto
ou informaes de datas. Quando aparecer em dgitos em um campo de caractere, eles
sero tratados como caracteres de texto, no como nmeros.
Dados numricos
Um grande nmero de tipos de dados foi desenvolvido para representar dados
numricos. O ACL l quase qualquer tipo de dados numricos e interpreta automaticamente a maioria dos tipos de dados no-proprietrios.
Dados lgicos
Os dados lgicos tm somente dois valores; um para representar Verdadeiro e outro
para representar Falso. Os dados lgicos normalmente so armazenados em um campo
de caractere, em um formato igual a T/F, S/N ou Ligado/Desligado. s vezes, ele
armazenado em um campo numrico ou de caractere, onde zero indica Falso e qualquer
outro valor indica Verdadeiro.
O ACL reconhece a maioria dos dados lgicos automaticamente.
Dados de data
As informaes sobre data so normalmente armazenadas como dados de caractere e,
s vezes, como dados numricos.
5

Tipos de campos do ACL
Manual de Referncia
No h tipos de dados atribudos especificamente para representar datas e no h

conveno universal para representar informaes sobre datas.
O ACL reconhece a maioria dos dados de data legveis. Entretanto, pode ser necessrio
especificar, manualmente, o formato da data quando os dados estiverem em um
formato comprimido, tais como um campo compactado.
Tipos de campos do ACL

Dentro de cada categoria de dados, h vrios tipos de dados, que correspondem aos tipos
de campos do ACL. Alguns tipos de dados so definidos pelos padres de indstria,
como o ASCII. Outros foram desenvolvidos para tratar de necessidades especficas de
um fabricante de computadores ou desenvolvedor de software, como IBMFloat ou
ACCPAC.
Categorias de dados e tipos de campos do ACL

Categoria de dados
Tipo de campo do ACL
Character (Caractere)
ASCII
EBCDIC
Custom (Personalizado)
PCASCII
Numeric (Numrico)
ACL
ACCPAC
BASIC
Binary (Binrio)
Float (Ponto flutuante)
Halfbyte (Meio byte)
IBMFloat (Ponto flutuante da IBM)
Micro
Numeric (Numrico)
Packed (Compactado)
Print (Imprimir)
Unisys
Captulo 1
Tipos de campo
Dados de origem e tipos de campo do ACL
Categoria de dados

Unsigned (Sem sinal)
Vaxfloat
Zoned (Zonado)
Logical (Lgica)
Logical (Lgico)
Date (Data)
Date (Data)
Dados de origem e tipos de campo do ACL

Ao utilizar o Assistente de definio de dados para criar uma nova definio de arquivo
de entrada, o ACL atribui um tipo de campo do ACL para o tipo dos dados de origem.
Embora este processo seja normalmente automtico, voc pode, em alguns casos, ter
que definir o tipo de dados de origem, utilizando campos calculados e funes.
A tabela abaixo faz uma referncia cruzada de uma srie de tipos de dados de origem
comuns com seus tipos de campos do ACL correspondentes. Alm dos tipos de dados
relacionados nesta tabela, o ACL suporta vrios tipos de dados proprietrios, como os
campos compactados VAXfloat e Unisys, bem como os tipos de dados numricos exclusivos para o sistema contbil ACCPAC.
O ACL tambm tem seu prprio tipo de campo para armazenar os resultados dos
campos calculados e valores de variveis numricas nos arquivos de dados de sada.
Tipos de dados de origem e tipos de campos do ACL

Tipo de dados fonte
Character (Caractere)
ASCII ou EBCDIC
PIC X (COBOL)
ASCII ou EBCDIC
String (Cadeia) (BASIC)
ASCII ou EBCDIC
Computational-1 (Computacional-1) (COBOL)
Binary (Binrio)
Computational-3 (Computacional-3) (COBOL)
Packed (Compactado)
PIC 999 (COBOL)
Zoned (Zonado)
Fixed Binary (Binrio fixo) (PL/1)
Binary (Binrio)

ACCPAC
Manual de Referncia
Tipo de dados fonte
Fixed Decimal (Decimal fixo) (PL/1)
Packed (Compactado)
Integer (Nmero inteiro) (na maioria dos micros)
Micro (comprimento 2)
Integer (Nmero inteiro) (maioria dos

mini/mainframes)
Binary (Binrio) ou Micro (comprimento 2)
Long (Largo)
Integer ou Micro (comprimento 4)
Real
Single Precision (Preciso nico) (BASIC)
BASIC (comprimento 4)
Double Precision (Preciso duplo) (BASIC)
BASIC (comprimento 8)
ACCPAC
L campos numricos de arquivos de dados ACCPAC.
Esse tipo de campo se refere ao formato numrico usado nos pacotes de contabilidade
ACCPAC. O comprimento desse campo de dados tem sempre 6 bytes (o ACL substitui
qualquer outro comprimento especificado).
ACL
L os valores dos campos calculados e das variveis armazenadas em um arquivo de
dados gerado pelo ACL.
O tipo de campo do ACL um campo de 8 ou 12 bytes que armazena os resultados e
clculos do ACL. Ele se destina ao armazenamento de grandes nmeros e no um
campo que pode ser impresso.
No necessrio definir um tipo de campo do ACL, porque o ACL o faz automaticamente.
ASCII
L dados codificados de acordo com a tabela ASCII (American Standard Code for
Information Interchange).
Captulo 1
Tipos de campo
BASIC
ASCII uma conveno de codificao especial para caracteres. o conjunto original

de caracteres da maioria dos minicomputadores e de todos os computadores pessoais. O
comprimento mximo de um campo ASCII de 32767 bytes. Um campo ASCII corresponde a um X em uma clusula PICTURE do COBOL. Para obter uma descrio de
outro formato principal de dados de caractere, consulte EBCDIC na pgina 15.
BASIC
L dados numricos gerados pelo BASIC interpretativo.
Esse tipo de campo especifica o padro BASIC (IBM PC) interpretativo adotado pela
maioria dos softwares de microcomputadores de linguagem BASIC para representao
de ponto flutuante. Entretanto, difere dos coprocessadores matemticos 8087 e 80287,
as CPUs 486 e Pentium e da maioria de outros softwares de PC.
Como norma para os tipos de campo numricos de microcomputador, o byte de menos
significativo do significando (mantissa) o primeiro a ser seqencialmente armazenado
at o byte mais significativo do expoente. Em outras palavras, os bytes so armazenados
em ordem inversa. O comprimento desse tipo de campo de 4 ou 8 bytes, como
definido pelo padro. Consulte Float (Ponto flutuante) na pgina 15 para obter uma
descrio do formato 8087 do Institute of Electrical and Electronic Engineers (IEEE).
Binary (Binrio)
L dados binrios numricos sem sinal, correspondentes ao tipo de campo fixed binary,
PL/1 ou ao tipo de dados COMPUTATIONAL-1 do COBOL.
Binary interpretado como um nmero, com o byte mais significativo vindo primeiro
(extremo esquerdo) e o byte menos significativo por ltimo, como norma nos dados
de mainframe. Esse tipo de campo no adequado aos campos binary (inteiros) dos
Micros, que geralmente armazenam o byte menos significativo primeiro. O equivalente
ao Binary dos micros o tipo de campo Micro.
O comprimento do tipo de campo binary tem no mximo 8 bytes. O nmero de casas
decimais o nmero implcito de dgitos decimais e no pode exceder o nmero de
dgitos especificados pelo comprimento.
Os campos binary de comprimento par so tratados como campos binrios com sinal
(complemento de dois) e os de comprimento mpar so tratados como campos sem
sinal (bytes zero de ordem superior implcitos so adicionados).
10

Manual de Referncia
L conjuntos de caracteres no padro. O tipo de dado custom pode ser til em aplicativos de idioma estrangeiro onde determinados caracteres so implementados de uma
forma fora dos padres comuns.
Como padro, o tipo de dado custom ASCII. Entretanto, possvel criar um arquivo
especial denominado custom.dat que contm valores substitutos para qualquer ou
todos os valores de caracteres ASCII padro. No h restries nas substituies de
caractere que podem ser feitas.
possvel criar o arquivo custom.dat usando qualquer editor de texto. Inclua o arquivo
no mesmo diretrio onde esto os arquivos executveis do ACL.
Custom.dat um arquivo de texto-padro com dois valores em cada linha. O primeiro
valor o caractere a ser substitudo; o segundo valor o caractere que o substituir. Os
valores podem ser especificados como caracteres, valores decimais ou hexadecimais:
Os valores decimais so especificados como nmeros simples, como 65 para o

caractere A.
Valores hexadecimais tm os dois dgitos hexadecimais precedidos por um X,
como X41 para o caractere A.
Valores de caractere so especificados como o prprio caractere, precedido por
um C, como CA para o caractere A.
Qualquer uma dessas trs convenes pode ser usada individualmente ou em combinao.
O arquivo custom.dat lido quando o ACL iniciado. Desse modo voc no poder
edit-lo enquanto o ACL estiver sendo executado. Nenhum dos valores especificados no
custom.dat deve exceder 255, que o maior valor que pode ser armazenado em um byte.
possvel usar qualquer editor de texto para exibir o arquivo custom.dat.
Por exemplo, se o campo de dados a ser lido estiver em ASCII, mas o sistema usar um
hexadecimal A4 para um sinal de cifro ($), um hexadecimal A5 para uma vrgula e um
nmero decimal 5 para um ponto decimal, voc poder defini-lo como um campo
custom. O contedo do arquivo custom.dat seria:
XA4C$
XA5C,
5C.
Captulo 1
Tipos de campo
Date (Data)
11
Date (Data)
Interpreta as informaes sobre data e as converte para o tipo de campo de data do ACL.
Para o ACL reconhecer as informaes sobre data, elas devem ser armazenadas em um
formato descomprimido e ser reconhecveis como informaes sobre data no arquivo
de dados fonte.
As informaes sobre data so armazenadas de vrias maneiras. As datas geralmente
so representadas por uma combinao de caracteres, nmeros e caracteres de
pontuao. s vezes as datas so representadas somente por nmeros. O ACL reconhece
automaticamente as informaes sobre data na maioria dos arquivos de dados.
Ele utiliza um formato de data para identificar as posies dos bytes no arquivo de dados
de origem que representam informaes sobre dia, ms e ano. O formato de data
criado automaticamente quando os dados so definidos por meio do Assistente de
definio de dados. O ACL apresenta sua avaliao do formato da data e permite
confirm-lo e modific-lo.
O formato da data no afeta a forma como as datas so exibidas no ACL. Para alterar a
forma como as datas so exibidas no ACL, consulte Opes de data na pgina 321 do
Guia do Usurio do ACL para Windows.
Datas em branco ou invlidas

O ACL atribui o valor 19000101 aos campos de data que contm espaos em branco
ou datas invlidas. Para localizar campos de data em branco:
1. Clique em
(Editar filtro de exibio) na exibio para visualizar a caixa de
dilogo Editar filtro de exibio.
2. Na caixa de texto Expresso, digite Campo_de_data = `19000101`, a seguir,
clique em [OK]. A exibio mostra somente os registros que tm um campo de data
em branco.
Dica: As datas digitadas manualmente por meio de teclado devem ser colocadas entre
acentos graves.
Ano de dois dgitos

Muitos arquivos de dados utilizam dois dgitos para representar o ano. O ano utilizado
para indicar a data mais antiga do ltimo sculo varia de um conjunto de arquivos de
dados para o seguinte. O ano de dois dgitos que indica o registro mais antigo do ltimo
sculo geralmente chamado data de incio do sculo ou data piv.
12

Date (Data)
Manual de Referncia
A forma com a qual o ACL l os anos de dois dgitos depende da definio da preferncia do Incio do Sculo. Com a definio padro de 40, o ACL interpreta os anos 40
a 99 como 1940 a 1999, e os anos 00 a 39 como 2000 a 2039. O ACL utiliza esta definio
sempre que encontra dados que utilizam dois dgitos para representar o ano em um
arquivo de entrada. Isto no afetar os dados que utilizam trs ou quatro dgitos para
representar o ano.
Para alterar a configurao padro, consulte Incio do sculo na pgina 323 do
Guia do Usurio do ACL para Windows. Consulte Set (Definir) na pgina 303.
Datas seriais
As datas, s vezes, so representadas por um nmero serial. Os esquemas de datas seriais
representam a data como o nmero de dias decorridos a partir de alguma data inicial
arbitrria, como 1o de janeiro de 1900. Quando voc cria uma definio de arquivo de
entrada, o ACL reconhece o nmero serial como dado numrico.
As datas seriais no podem ser convertidas automaticamente para o tipo de campo de
data do ACL. Posteriormente necessrio utilizar as funes ACL para converter o
nmero serial em uma data, em um novo campo calculado. Consulte Datas em srie
na pgina 295 do Guia do Usurio do ACL para Windows.
Datas em campos numricos comprimidos

O ACL no pode reconhecer automaticamente as datas armazenadas em campos
numricos comprimidos, tais como campos de dados compactados. Ao ser criada uma
definio de arquivo de entrada, o ACL reconhece os dados compactados como dados
numricos compactados.
Para o ACL reconhecer os dados numricos compactados como informaes de datas,
necessrio editar a definio de arquivo de entrada, selecionar o campo, selecionar o
parmetro Data e especificar o formato da data. O formato da data indica quais
nmeros no arquivo de origem representam o dia, o ms e o ano.
Exemplo
preciso especificar o formato da data quando as datas estiverem armazenadas em
campos numricos comprimidos, tais como campos compactados.
1. Na barra de menus, selecione Editar e escolha definio de arquivo de entrada. O
ACL exibir a janela definio de arquivo de entrada.
2. Na guia [Editar campos/expresses], na exibio da lista de campos, d um clique
duplo no campo numrico compactado que voc deseja editar. O ACL exibe as
opes de formato de campo.
Captulo 1
Tipos de campo
Date (Data)
13
3. Clique na caixa de verificao do parmetro Data.

4. Especifique o formato de data na lista suspensa Formato.
Atributos do campo
Designa o modificador
de campo de data
Parmetros
Por exemplo, se a data no arquivo de dados fonte tiver o formato AAMMDD, voc
selecionaria o mesmo formato na lista suspensa. Observe que os campos numricos no
podem conter pontuao no formato.
Formatos de data
Quando voc define o formato de um campo de data, informa ao ACL quais caracteres
representam o dia, o ms e o ano. O ACL utiliza os seguintes caracteres de formato para
representar os elementos de um campo de data:
Caracteres de formato
Elemento de data
DD
Dia (1 31)
DDD
Dia juliano (1 366)
MM
Ms (1 12)
MMM
Nome do ms (Jan. Dez.)
AA
Formato abreviado de ano (1 99)
AAAA
Formato por extenso de ano (1900 1999)
14

Date (Data)
Manual de Referncia
Coloque separadores, como um smbolo de barra (/), na mesma posio relativa que
estiverem no arquivo de dados de origem. Se voc no fizer isso, o ACL no interpretar
a data corretamente. O formato que voc define deve corresponder ao formato da data
armazenada. A tabela a seguir mostra diferentes maneiras de uma data ser armazenada
em um arquivo de entrada e como voc descreveria o formato para o ACL.
Data armazenada
Formato de data ACL
991231
AAMMDD
12311999
MMDDAAAA
31DEZ1999
DDMMMAAAA
12/31/99
MM/DD/AA
99365
AADDD
Dezembro 31, 1999
MMM DD, AAAA
Convenes de formatao de data

H muitas convenes de formatao de data em uso. As mais comuns so mostradas na
tabela abaixo.
Formato de data comum
Tipo
Exemplo utilizando
dezembro 31, 1999
AAAA-MM-DD
ISO
1999-12-31
DD/MM/AA, DD.MM.AA, ou DD-MM-AA
Europeu
31/12/99
MM/DD/AA
Norte-americano
12/31/99
AADDD
Juliano
99365
Sintaxe do modo de comando

Voc pode descrever o formato das datas armazenadas em campos numricos utilizando o modificador de campo de data NDATE, seguido pelo formato de data. Por
Captulo 1
Tipos de campo
EBCDIC
15
exemplo, para descrever um campo com nmeros na forma de 991231 como uma data,
voc utilizaria o modificador de campo NDATE conforme mostrado abaixo:
DEFINE FIELD Campo_de_data NUMERIC 1 6 0 NDATE PIC "YYMMDD"
Nota: NDATE a linha de comando equivalente ao parmetro de data na tela de

definio de campo da janela de definio de arquivo de entrada. Normalmente mais
utilizado para definir datas em campos de data numricos compactados.
Cdigos de sculo para anos de dois dgitos em campos compactados

Para obter mais informaes, consulte Cdigos de sculo em campos de data compactados na pgina 18.
EBCDIC
L os dados codificados de acordo com o Extended Binary Coded Decimal Interchange
Code (EBCDIC).
Como o ASCII, o EBCDIC se refere a caracteres que podem ser impressos. Esse tipo de
campo a norma para todos os minicomputadores e mainframes da IBM. O comprimento mximo desse tipo de campo 32767 bytes.
Para obter mais informaes, consulte ASCII na pgina 8 para obter uma descrio
das outras formas principais de dados de caractere.

L os dados codificados de acordo com o padro IEEE para nmeros de ponto flutuante
de dupla preciso, como os dados produzidos com o coprocessador 8087 ou CPUs com
processador 486 e superiores.
Float o padro adotado para a maioria dos softwares de microcomputador, entretanto,
no o usado pelo BASIC interpretativo. Float armazena o byte menos significativo do
significando (mantissa) primeiro (extrema esquerda) e o mais significativo extrema
direita. O comprimento do tipo de campo de 4 ou 8 bytes.
Halfbyte (Meio byte)

L dados compactados alinhados em meio byte, que geralmente so encontrados em
ambientes Unisys/Burroughs. Nmeros com sinal devem seguir a conveno
Unisys/Burroughs.
16

IBMfloat (Ponto flutuante da IBM)
Manual de Referncia
De modo diferente de todos os outros tipos de campos que podem ser lidos pelo ACL, o
incio e o comprimento para esse tipo de campo so especificados em meio bytes, em
vez de bytes.
Por exemplo, para definir um campo halfbyte que se inicia no primeiro meio byte do
byte 3 e tem o comprimento de 10, voc deve clicar e arrastar para realar o campo na
janela Definio de arquivo de entrada, normalmente.
Em seguida, necessrio converter a posio inicial do campo em bytes (n) para meio
byte, usando a frmula (n*2)-1:
(3*2)-1=5
Em nosso exemplo, voc digitaria 5 na caixa de texto Iniciar e selecionaria HALFBYTE

na caixa suspensa Tipo, antes de clicar em
para concluir a definio de campo.
Se os dados estiverem alinhados em byte, pode ser mais conveniente usar os tipos de
campo unsigned ou Unisys.
IBMfloat (Ponto flutuante da IBM)

L dados de ponto flutuante da IBM.
O tipo de campo IBMfloat no comum, sendo encontrado principalmente em aplicativos cientficos para mainframe. Campos IBMfloat podem ter 4 ou 8 bytes de comprimento.
Logical (Lgico)
L dados em ASCII ou EBCDIC que tenham um valor lgico verdadeiro ou falso.
Logical refere-se a um campo com um byte de comprimento, que pode ser zero (falso)
ou no-zero (verdadeiro).
Nota: O ACL trata os dgitos (ASCII e EBCDIC) F (para Falso), 0 (para zero) ou N
(para No) (em maisculo ou minsculo) como falsos, apesar de, normalmente, avaliar o
valor diferente de zero como verdadeiro. Isso para poder usar os caracteres T e F, 0 e
1 ou Y e N como valores lgicos. O ACL tambm considera um branco ASCII (hex 20)
como falso, compatvel com produtos dBASE.
Captulo 1
Tipos de campo
Micro
17
Micro
L dados numricos binrios sem sinal criados em PCs e minicomputadores DEC.
Micro refere-se a um nmero binrio que armazena o byte menos significativo primeiro
e o mais significativo por ltimo. Esse tipo de campo no para campos binrios de
mainframe e de minicomputadores, que normalmente armazenam o byte mais significativo primeiro. Para obter mais informaes, consulte Binary (Binrio) na pgina 9.
O comprimento mximo do tipo de campo micro de 8 bytes. O nmero de decimais
o nmero implcito de dgitos decimais e no pode ser maior que o nmero de dgitos
implcitos no comprimento.
Os campos micro com comprimento par so tratados como campos binrios com sinal
(complemento de dois) e campos com comprimento mpar so tratados como campos
sem sinal (bytes de ordem superior zero implcitos so adicionados). Esse tipo de
campo apropriado para a representao de dados integer ou long de microcomputadores.
Numeric (Numrico)
L dados numricos ASCII ou EBCDIC que podem ser impressos e correspondem ao
tipo de campo display do COBOL.
Numeric refere-se a nmeros imprimveis em ASCII ou EBCDIC, em oposio aos
compactados ou zonados. Esse tipo de campo pode incluir qualquer pontuao, mas a
mais comum inclui espaos em branco iniciais ou finais, um sinal inicial ou final
opcional, pontos e uma vrgula decimal explcita. Numeric trata os zeros iniciais como
espaos em branco. Tem um comprimento mximo de 40 bytes (at 22 dgitos).
Nota: Casas decimais referem-se a dgitos decimais implcitos. Se uma definio de campo
incluir decimais sem nenhuma vrgula decimal explcita, uma vrgula decimal ser
implcita. Por exemplo, em um campo com duas casas decimais, o ACL interpretar 123
como 1,23; 12,3 como 12,30 e 12, como 12,00.
Se as casas decimais especificadas diferirem dos decimais explcitos no campo, este ser
arredondado para o nmero de decimais apropriado.
O ACL interpretar corretamente parnteses e CR como negativo, mas ignorar
vrgulas e outras pontuaes (como $). Os sinais podem ser iniciais ou finais, fixos ou
flutuantes.
18

Packed (Compactado)
Manual de Referncia
Packed (Compactado)
L o tipo de campo numrico compactado gerado por mainframes.
Packed refere-se ao tipo de campo numrico compactado de mainframe que armazena
dois dgitos numricos por byte. O byte mais direita contm uma indicao de sinal na
metade inferior do byte (normalmente HEX C para positivo e HEX D para negativo).
A metade superior do byte extremo direito e cada metade de todos os outros bytes
contm um dgito hexadecimal representando o dgito decimal daquela posio no
nmero.
O comprimento mximo desse tipo de campo de 12 bytes (23 dgitos), entretanto, o
ACL gera uma mensagem de erro se encontra um nmero maior que 22 dgitos. Conseqentemente, quando voc definir um campo numrico compactado na janela
Definio de arquivo de entrada, o nmero de decimais que voc especifica na caixa de
texto Formato no deve resultar em um nmero maior que 22 dgitos. Por exemplo, se
os seus dados contiverem nmeros de sete dgitos, voc no poder especificar mais de
15 casas decimais (22 dgitos 7 dgitos).
O tipo de campo numrico compactado corresponde aos tipos de dados fixed decimal
do PL/1 e computational-3 do COBOL.
Nota: Embora a especificao da IBM para esse tipo de campo indique que os sinais dos
hex B e D representam valores negativos, quase todos os softwares usam apenas o D
para negativos. Assim sendo, o ACL trata B como positivo para ser compatvel com alguns
hardwares que no sejam da IBM. Se isto causar um problema no seu ambiente, entre em
contato com o Suporte Tcnico para obter assistncia.
Para obter mais informaes sobre os dados compactados Unisys, consulte Unisys na
pgina 21.
Datas em campos numricos compactados

Voc deve especificar manualmente o formato da data quando as datas forem armazenadas em campos numricos comprimidos, tais como campos compactados. Para obter
mais informaes, consulte Para fazer com que o ACL reconhea o cdigo de sculo
na pgina 19.
Cdigos de sculo em campos de data compactados

Dois dgitos vm sendo utilizados h muito tempo para representar o ano em campos
numricos compactados utilizados para armazenar datas. Alguns sistemas agora
adicionam um terceiro dgito chamado cdigo de sculo para indicar o sculo ao qual o
ano de dois dgitos pertence.
Captulo 1
Tipos de campo
Packed (Compactado)
19
Os cdigos de sculo mais comuns utilizam um 0 inicial ou um 1 inicial para indicar

o sculo vinte:
Quando um 0 inicial for utilizado no campo compactado para representar

1900, qualquer outro nmero, geralmente 1, representa 2000.
0990101 representa 1o de janeiro de 1999.
Quando um 1 inicial for utilizado no campo compactado para representar

1900, qualquer outro nmero, geralmente 2, representar 2000.
Para fazer com que o ACL reconhea o cdigo de sculo

Depois de utilizar o Assistente de definio de dados para definir um campo numrico
compactado, necessrio modificar manualmente o formato de data como segue:
1. Selecione Editar na barra de menus e escolha Definio de arquivo de entrada. O
ACL exibir a janela Definio de arquivo de entrada.
2. Na guia [Editar campos/expresses], na exibio de lista de campos, d um clique
duplo no campo numrico que voc deseja editar. O ACL exibe as opes de formato
de campo.
3. Clique na caixa de verificao Data.
4. Especifique um formato de data na lista suspensa Formato. Em seguida, na caixa de
texto Formato, adicione um 0 ou um 1 no incio do formato do campo de data
compactado para especificar o dgito que representa os anos de 1900.
Por exemplo, o formato 0AAMMDD indica que 0991231 31 de dezembro de
1999. Similarmente, 1AAMMDD indica que 1991231 31 de dezembro de 1999.
5. Clique em
alterao.
(Aceitar entrada), em seguida, clique em [OK] para salvar a
Voc pode visualizar o campo formatado na janela Exibio.
20

PCASCII
Clicar para aceitar

a alterao
Manual de Referncia
Especificar formato de data
Data exibida como 1990101
Clicar para salvar formato
PCASCII
L dados codificados de acordo com o ASCII (American Standard Code for Information Interchange).
O tipo de campo PCASCII quase o mesmo tipo de campo ASCII. Voc pode us-lo
quando os dados em um arquivo forem criados em um aplicativo DOS, ou quando o
arquivo incluir caracteres de idioma estrangeiro. O tipo de campo PCASCII assegura
que os caracteres de idioma estrangeiro sejam corretamente interpretados.
O formato do tipo de campo idntico ao formato do tipo de campo ASCII.
Print (Imprimir)
L dados numricos ASCII ou EBCDIC imprimveis.
Esse campo exatamente igual ao numeric, exceto pelo seu tratamento de campos com
nenhuma vrgula decimal explcita. Se uma definio de campo incluir casas decimais,
mas nenhuma vrgula decimal explcita, Print assumir que no existem decimais para
o registro.
Captulo 1
Tipos de campo
Unisys
21
Por exemplo, em um campo com duas casas decimais, 123 interpretado como 123,00;
12,3 como 12,30 e 12, como 12,00.
O comprimento mximo desse tipo de campo de 40 bytes, entretanto, o ACL gera uma
mensagem de erro se um nmero maior que 22 dgitos for encontrado.
O tipo de campo Print corresponde ao tipo de campo display do COBOL, completo com
pontos, sinal e vrgula. Print no apenas ignora os pontos, mas interpreta corretamente
parnteses e CR como negativo. Os sinais podem ser iniciais ou finais, fixos ou flutuantes e qualquer outra pontuao (como $) ignorada.
Unisys
L dados compactados da Unisys/Burroughs alinhados por byte.
Campos packed da Unisys/Burroughs, de maneira diferente que os campos IBM
compactados, tm o sinal do lado esquerdo em vez do direito. O tipo de campo Unisys
se refere ao tipo de campo packed do mainframe da Unisys/Burroughs que armazena
dois dgitos decimais por byte. Esse tipo de campo no pode ser impresso.
O byte mais esquerda do campo contm uma indicao de sinal na metade superior do
byte, que normalmente hexadecimal C ou F para positivo e hexadecimal D para
negativo. Cada metade de todos os outros bytes contm um dgito hex que o valor do
nmero nessa posio.
O comprimento mximo desse tipo de campo de 12 bytes, mas o ACL ir gerar uma
mensagem de erro se um nmero maior que 22 dgitos for encontrado. O nmero de
decimais o nmero de dgitos decimais implcito e no pode exceder o nmero de
dgitos implicado pelo comprimento.
Dados Unisys compactados sem sinal devem ser especificados como unsigned, porque
seu formato o mesmo formato da IBM.
Nota: Computadores da Unisys podem trabalhar com dados alinhados em meio byte e
dados com comprimento de meio byte, mas o tipo de campo Unisys incompatvel com eles.
Para ler esses dados, use o tipo de campo halfbyte como descrito em Halfbyte (Meio byte)
na pgina 15.
22

Manual de Referncia

L dados compactados sem sinal originados no mainframe.
Unsigned refere-se ao tipo de campo compactado sem sinal para dados de mainframe,
armazenando dois dgitos decimais por byte.
De forma diferente que o tipo compactado, unsigned no contm uma indicao de
sinal na metade inferior do byte extrema direita. Cada metade de um byte contm um
dgito hexadecimal representando o dgito decimal daquela posio do nmero. O
comprimento mximo desse tipo de campo de 11 bytes (em outras palavras, 22 dgitos
decimais). O nmero de casas decimais no pode exceder o nmero mximo de dgitos
possveis para este campo.
VAXfloat
L dados de ponto flutuante DEC VAX tipo D, que a mais comum das quatro representaes de ponto flutuante do VAX.
O comprimento desse tipo de campo de 4 ou 8 bytes.
Zoned (Zonado)
L dados numricos ASCII ou EBCDIC do tipo de campo decimal zonado (IBM) ou
PIC S9(n) (COBOL). Em outras palavras, l quaisquer dados zonados, incluindo os
gerados pelas mquinas DEC, Honeywell e IBM.
ZONED se refere aos campos numricos zoned de mainframe, um dgito por byte,
codificados em ASCII ou EBCDIC. Os zeros iniciais devem ser retidos. A metade
superior do byte extremo direito do campo inclui o sinal negativo. O comprimento
mximo de um campo zoned de 22 bytes.
O tipo de campo decimal zonado da IBM e o tipo de campo PIC S9(n) do COBOL so
comumente exibidos como um nmero de dgitos seguidos por uma letra indicando o
sinal.
O tipo de campo zoned compatvel com os tipos de campo DEC DIBOL, no qual uma
letra minscula entre p e y indica valores negativos. O ACL detecta automaticamente e ajusta para campos zoned de acordo com os formatos IBM, Honeywell e DEC.
Captulo 2
F UNES
As funes do ACL so divididas em oito categorias para ajud-lo a identificar suas

finalidades. Quando voc estiver trabalhando no Construtor de expresses, ser
possvel visualizar as funes na lista suspensa Funes. Para visualizar todas as
funes, selecione Tudo na lista. Para visualizar um subconjunto de funes, selecione a
categoria na lista.
Resumo das funes

Funes de bit/caractere
ASCII( )
Retorna o valor decimal ASCII do primeiro caractere de uma expresso.
BIT( )
Retorna uma cadeia de 0s e 1s, representando uma posio de byte

especificada no registro atual.
BYTE( )
Retorna o byte para a posio especificada no registro atual.
CHR( )
Retorna o caractere ASCII correspondente ao valor decimal especificado.
DIGIT( )
Retorna o dgito superior ou inferior de um byte compactado

especificado.
HEXADECIMAL( )
Retorna uma cadeia de valores hexadecimais, representando o contedo

de um campo.
MASK( )
Extrai bits individuais do primeiro byte de uma expresso com caracteres.
SHIFT( )
Desloca o primeiro caractere de uma expresso para a esquerda ou

direita, substituindo por um nmero especificado de bits.
Funes de converso
DECIMALS( )
Retorna uma expresso numrica com um nmero especificado de casas

decimais.
EBCDIC( )
Converte uma cadeia em caracteres EBCDIC.
PACKED( )
Converte dados numricos em dados tipo PACKED, com um comprimento

especificado.
STRING( )
Converte uma expresso numrica em uma cadeia de caracteres.
23
24

Resumo das funes
Manual de Referncia
UNSIGNED( )
Converte dados numricos em dados tipo UNSIGNED, com um

comprimento especificado.
VALUE( )
Converte uma expresso com caracteres no equivalente numrico.
ZONED( )
Converte os dados numricos em formato de dados ZONED.
Funes de data e hora

AGE( )
Retorna o perodo (em dias) de uma data comparada a uma data limite
especfica ou com a data do sistema atual.
CDOW( )
Retorna o nome do dia da semana para uma data especificada.
CTOD( )
Converte uma expresso com caracteres ou numrica em uma expresso

de data vlida, para comparao com valores de campo de data.
DATE( )
Converte uma expresso de data, a data do sistema atual ou um valor de

campo de data em uma cadeia de caracteres legveis, como uma data.
DOW( )
Retorna um valor numrico representando o dia da semana para uma

data especificada.
TIME( )
Retorna a data e hora a partir do relgio do sistema.
Funes lgicas
BETWEEN( )
Testa se os valores de entrada se encaixam dentro de um intervalo

especificado.
FIND( )
Pesquisa uma cadeia em um campo ou registro.
ISBLANK( )
Testa se um valor de entrada est totalmente em branco.
MAP( )
Compara uma cadeia com um formato especificado.
MATCH( )
Compara uma expresso ou valor de campo com expresses

especificadas ou valores de campo, a fim de determinar se existe ao
menos uma correspondncia.
SOUNDSLIKE( )
Indica se duas cadeias tm sons foneticamente iguais.
TEST( )
Pesquisa cadeias de caracteres em locais especificados de um registro.
VERIFY( )
Pesquisa dados invlidos.
Captulo 2
Funes
Resumo das funes
Funes matemtica
ABSOLUTE( )
Retorna o valor absoluto de uma expresso numrica.
EXPONENT( )
Retorna o valor exponencial (base 10) de uma expresso numrica.
FREQUENCY( )
Retorna a freqncia de Benford esperada para dgitos numricos

positivos iniciais seqenciais com uma preciso de oito dgitos.
INTEGER( )
Retorna o valor inteiro de uma expresso numrica.
LOGARITHM( )
Retorna o logaritmo (base 10) de uma expresso numrica.
MAXIMUM( )
Retorna o maior dentre dois parmetros numricos.
MINIMUM( )
Retorna o menor dentre dois parmetros numricos.
MOD( )
Retorna o resto de um clculo de diviso.
RANDOM( )
Retorna um nmero aleatrio entre zero e o valor de uma expresso

numrica.
ROOT( )
Retorna a raiz quadrada de uma expresso numrica.
ROUND( )
Retorna um nmero arredondado a partir de uma expresso numrica.
ZSTAT( )
Calcula a estatstica Z padro para ser utilizada em muitas tarefas de

soluo de problemas, incluindo anlise digital.
Funes financeiro
EFFECTIVE( )
Retorna a taxa de juros efetiva anual de um emprstimo.
FVANNUITY( )
Retorna o valor futuro de uma seqncia de pagamentos.
FVLUMPSUM( )
Retorna o valor futuro de uma soma global.
NOMINAL( )
Retorna a taxa de juros nominal anual.
NPER( )
Retorna os perodos necessrios para liquidar um emprstimo.
PMT( )
Retorna os pagamentos peridicos necessrios para liquidar um

emprstimo.
PVANNUITY( )
Retorna o valor presente de uma seqncia de pagamentos.
PVLUMPSUM( )
Retorna o valor presente de uma soma global, a vencer em diversos

perodos.
RATE( )
Retorna a taxa de juros por perodo.
25
26

Resumo das funes
Manual de Referncia
Funes diversas
FILESIZE( )
Retorna o tamanho de um arquivo especificado em bytes.
FTYPE( )
Retorna o tipo de um campo especificado.
LEADING( )
Retorna uma cadeia de caracteres contendo um nmero especificado

de dgitos no incio.
OFFSET( )
Ajusta a posio inicial de um campo no registro atual.
RECLEN( )
Retorna o comprimento do registro atual.
RECNO( )
Retorna o nmero do registro lgico atual.
Funes de acesso em cadeias

ALLTRIM( )
Remove espaos em branco no incio e no fim de cadeias de

caracteres. No afeta os espaos em branco dentro da cadeia.
AT( )
Localiza onde comea uma ocorrncia especificada de uma cadeia de

caracteres dentro de outra cadeia de caracteres.
BLANKS( )
Cria uma cadeia de caracteres de comprimento especificado,

consistindo exclusivamente de espaos em branco. Compare com
REPEAT( ), a seguir.
CLEAN( )
Descobre quaisquer caracteres invlidos em uma cadeia e os substitui,

assim como a todos os caracteres subseqentes, por espaos em
branco.
EXCLUDE( )
Compara duas cadeias e retorna uma cadeia contendo apenas os

caracteres no-comuns a ambas.
INCLUDE( )
Compara duas cadeias e retorna uma, contendo apenas os caracteres

comuns a ambas.
INSERT( )
Insere caracteres ou espaos em branco em um local especificado em

uma cadeia de caracteres.
LAST( )
Captura um nmero especificado de caracteres do final de uma

cadeia.
LENGTH( )
Calcula o nmero de caracteres em uma cadeia especificada.
LOWER( )
Converte para minsculo todos os caracteres alfabticos de uma

expresso.
Captulo 2
Funes
Resumo das funes
LTRIM( )
Remove espaos em branco do incio de uma cadeia.
OCCURS( )
Conta o nmero de ocorrncias de uma cadeia de caracteres em uma

cadeia maior.
PROPER( )
Converte para maisculo ou minsculo os caracteres alfabticos de

uma cadeia, de forma adequada aos nomes prprios.
REMOVE( )
Remove caracteres indesejados de uma cadeia de caracteres.
REPEAT( )
Cria uma cadeia de caracteres que repete, por um nmero

especificado de vezes, um valor constante. Compare com BLANKS
acima.
REPLACE( )
Substitui todas as ocorrncias de uma cadeia de caracteres por outra.
REVERSE( )
Inverte a ordem dos caracteres em uma cadeia.
RJUSTIFY( )
Justifica direita uma cadeia para um comprimento especificado e

move quaisquer espaos em branco no final para o incio da cadeia.
SOUNDEX( )
Retorna um valor de quatro caracteres para uma cadeia, o qual pode

ser comparado ao valor de outra cadeia, a fim de verificar se ambas
so foneticamente similares.
SPLIT( )
Retorna um segmento especificado de uma cadeia de caracteres

delimitada por separadores, como espaos ou vrgulas.
SUBSTRING( )
Retorna uma subcadeia de uma expresso com caracteres.
TRANSFORM( )
Permite que caracteres hebraicos sejam exibidos da maneira

adequada em uma cadeia.
TRIM( )
Remove espaos em branco do final de uma cadeia.
UPPER( )
Converte para maisculo todos os caracteres alfabticos de uma

expresso.
27
28

ABSOLUTE( )
Manual de Referncia
ABSOLUTE( )
ABS( ) retorna o valor absoluto de uma expresso numrica.
Use ABS( ) para determinar o valor absoluto de uma populao, antes de gerar uma
amostra aleatria.
Formato da funo
ABS(N)
A funo ABS( ) retorna o valor absoluto da expresso numrica N especificada.
Exemplos
ABS(-7,2) = 7,2
ABS(88,2)= 88,2
ABS(5)= 5
Para criar um campo que seja a diferena entre dois campos (AMT1 e AMT2), especifique:
ABS(AMT1 - AMT2)
AGE( )
AGE( ) retorna o perodo, em dias, de uma data especificada, comparada com uma data
limite especificada.
Use AGE( ) ao comparar duas datas, a fim de determinar contas vencidas ou executar
anlises de vencimento de saldos.
Formato da funo
AGE(C|D <;C|D>)
AGE( ) retorna um valor numrico indicando a diferena de vencimento, em dias, entre

duas datas. Ao omitir o segundo parmetro, o ACL utiliza a data atual do sistema. No
entanto, quando includo o segundo parmetro, o ACL calcula o vencimento relativo
ao final do ano fiscal ou outras datas limite.
Independente do formato no qual o campo da data armazenado, ao se usar constantes,
elas devem ser:
Uma cadeia de caracteres ou expresso na forma AAMMDD ou AAAAMMDD
Uma constante de data de forma AAMMDD ou AAAAMMDD
Uma expresso de data vlida do ACL
Captulo 2
Funes
ALLTRIM( )
29
As datas anteriores data limite retornam com um valor positivo. As datas posteriores
data limite retornam com um valor negativo.
As datas aceitveis esto no intervalo de 1 de janeiro de 1900 at 31 de dezembro de
9999.
Exemplos
Supondo-se que a data atual do sistema seja 1 de janeiro de 1996:
AGE(`951220`) = 12
AGE(`19960108`) = -7
AGE(`19941220`;`950101`) = 12
AGE(Datefld) = 65
AGE(DueDate;`961231`) = 80
Para extrair o nome, valor e data da fatura de todos os itens vencidos h mais de 180 dias
(at o final do ano fiscal), especifique:
AGE(DATE;`961231`)>180
ALLTRIM( )
ALLTRIM( ) retorna uma cadeia de comprimento varivel, com os espaos em branco
no incio e no fim removidos. Os espaos em branco dentro da cadeia de caracteres no
so removidos.
ALLTRIM( ) similar a LTRIM( ), que remove os espaos em branco no incio e a
TRIM( ), que remove os espaos em branco no fim da cadeia de caracteres.
Formato da funo
ALLTRIM(C)
Exemplos
ALLTRIM("
ALLTRIM("
abc
a bc
") = "abc"
") = "a bc"
ASCII( )
ASCII( ) retorna o valor decimal ASCII do primeiro caractere de uma expresso com
caracteres especificada ou campo de caracteres. Essa funo o inverso da funo
CHR( ).
Use ASCII( ) para verificar os valores do campo de caracteres quando os caracteres no
puderem ser impressos, como tabulaes.
30

AT( )
Manual de Referncia
Formato da funo
ASCII(C)
ASCII( ) analisa o primeiro caractere na expresso com caracteres C e retorna um

nmero decimal que representa o valor.
Certifique-se de que C esteja delimitado por aspas, caso seja uma constante.
Exemplos
ASCII("A") = 65
ASCII("1") = 49
Para extrair os registros que contm um caractere de tabulao (valor decimal=9) no

incio do campo DESC, especifique:
ASCII(DESC) = 9
AT( )
AT( ) retorna a posio de uma cadeia de caracteres dentro de outra cadeia de caracteres. necessrio especificar que ocorrncia da cadeia deve ser pesquisada. Se no for
localizada a cadeia, ser retornado um valor zero.
Para a maioria das aplicaes, que desejam apenas saber se uma cadeia est presente, a
funo FIND( ) a alternativa mais fcil. AT( ) ainda requerida se for necessria a
localizao da cadeia ou se voc estiver pesquisando vrias ocorrncias.
Use AT( ) para procurar um valor especfico em um campo de texto livre (como uma
descrio, nome ou endereo).
Formato da funo
AT(N;C1;C2)
AT( ) pesquisa cadeias dentro de outras cadeias e possui trs argumentos: N, C1 e C2.
N especifica qual ocorrncia da cadeia C1 deve ser pesquisada.
C1 especifica a cadeia de caracteres que deve ser pesquisada.
C2 especifica a cadeia de caracteres a ser pesquisada.
O valor retornado uma localizao dentro da cadeia pesquisada, C2. AT( ) pode ser
interpretada como em qual posio est a N-sima ocorrncia da cadeia C1 na cadeia
C2?.
Captulo 2
Funes
AT( )
31
Se C1 for localizada N vezes em C2, AT( ) retorna a posio do primeiro caractere da

N-sima ocorrncia em C2. Se C1 no ocorrer N vezes em C2, AT( ) retorna zero.
Nota: AT( ) distingue entre maisculas e minsculas, portanto, a no igual a A. Se
voc estiver pesquisando valores em dados contendo maisculas e minsculas, deve considerar a converso dos dados em maisculas, com a funo UPPER( ).
Para obter mais informaes, consulte FIND( ) na pgina 305.
Exemplos
AT(1;
AT(2;
AT(2;
AT(3;
"ABC"; "ABCDEFG")= 1
"ABC"; "ABCDEFGABCDEFG")= 8
"A"; "ABCDEFGH")= 0
"ABC"; "ABCDEFGABCDEFG")= 0
Para extrair todos os registros nos quais o endereo Wild Street, especifique:
AT(1;"WILD";UPPER(ADDRESS))>0
Extrair registros
Condio
Nome do arquivo extrado
A funo UPPER( ) utilizada para que a pesquisa no faa distino entre maisculas
e minsculas. Se a expresso AT( ) retornar um valor maior que zero, Wild foi encontrado no campo Address e o registro ser extrado.
Nota: Este teste tambm localizar Wilder St. e Swilden Ave. Para ser mais especfico,
voc poder incluir um espao em branco, antes e depois de WILD.
32

BETWEEN( )
Manual de Referncia
Para contar o nmero de registros de um arquivo nos quais o nome Doe, especifique:
AT(1; "DOE";NAME)>0
Ou, se os dados contiverem caracteres maisculos e minsculos misturados, especifique:

AT(1; "DOE";UPPER(NAME))>0
BETWEEN( )
BETWEEN( ) retorna Verdadeiro ou Falso, dependendo se um valor especificado
estiver entre um valor mnimo ou mximo, incluindo estes dois valores.
Use BETWEEN( ) para testar intervalos de valores, tal como testar se uma quantidade se
encontra entre 20.000 e 60.000, incluindo. Tambm possvel us-lo para testar intervalos de datas ou de caracteres alfabticos.
Formato da funo
BETWEEN(valor;mnimo;mximo)
ou
BETWEEN(valor;mximo;mnimo)
Os trs parmetros devem ser do mesmo tipo: numrico, data ou caractere.

BETWEEN( ) retorna Verdadeiro se o valor estiver entre o mnimo e o mximo
inclusive, e Falso se no estiver. Os valores iguais ao mnimo e ao mximo tambm
retornaro Verdadeiro.
Quando os campos numricos tm preciso decimal diferente, a comparao usa o nvel
mais alto de preciso encontrado em qualquer um dos campos.
Captulo 2
Funes
BIT( )
33
Os formatos de data podem diferir para os trs parmetros, uma vez que o ACL avalia a
data independentemente de como est armazenada em um arquivo de dados ou
apresentada em uma visualizao.
As comparaes de caracteres distinguem maisculas e minsculas. A ordem de classificao dos caracteres depende do idioma selecionado na guia [Opes do arquivo de
entrada] da caixa de dilogo Editar preferncias do ACL. As opo Comparaes exatas
de caractere do ACL rege a forma como o ACL compara as cadeias de caracteres. Se a
opo Set Exact estiver desativada, A considerado igual a ABC e ABXYZ. Se a
opo Set Exact estiver ativada, A no considerado igual a ABC. A configurao
padro para esta opo OFF.
Para obter mais informaes consulte Comparaes exatas de caractere na pgina 315
do Guia do Usurio do ACL para Windows.
Exemplos
BETWEEN(5;4;7) = T
BETWEEN(5;5;7) = T
BETWEEN(5;6;7) = F
BETWEEN("abc";"A";"B") = F (Observao: retornado um valor
Falso, porque a comparao distingue entre maisculas e
minsculas)
BETWEEN("ABC";"A";"B") = T
BETWEEN("BCD";"ABC";"BB") = F
BETWEEN(`20011131`;`20011031`;`20011131`) = T
BIT( )
BIT( ) retorna a cadeia de bits, representando uma posio de byte especificada no
registro atual. Use BIT( ) para examinar os bits individuais em um byte. BIT( ) opera de
modo semelhante funo BYTE( ) na pgina 35.
Formato da funo
BIT(N)
BIT( ) converte o byte na localizao N do registro atual em uma cadeia com oito caracteres de comprimento, de 0s e 1s, que representa o byte.
34

BIT( )
Manual de Referncia
Exemplos
Para atribuir os valores de bit para os bytes 8, 9 e 17 para as variveis b8, b9 e b17, especifique:
ASSIGN b8= BIT(8)
ASSIGN b9= BIT(9)
ASSIGN b17= BIT(17)
Voc encontrar:
b8 = 00110001 se o oitavo byte contiver 1
b9 = 01000001 se o nono byte contiver A
b17 = 01100001 se o dcimo stimo byte contiver a
Suponha que a posio do byte 17 contenha um conjunto de 8 sinalizadores de crdito.

Para extrair todos os registros de cliente nos quais o terceiro bit esteja definido como 1
(significando no embarcar), especifique:
SUBSTR(BIT(17);3;1)="1"
Extrair registros
Condio
Nome de arquivo extrado
Neste exemplo, SUBSTR( ) usado para examinar o terceiro bit.
Captulo 2
Funes
BLANKS( )
35
BLANKS( )
BLANKS( ) cria uma cadeia de caracteres de comprimento especificado, consistindo
exclusivamente de espaos em branco.
Use BLANKS( ) para formatar um campo com espaos em branco, a fim de inicializar
uma varivel ou tornar um campo maior, por meio da adio de um nmero fixo de
espaos em branco.
Formato da funo
BLANKS(#)
BLANKS( ) retorna uma cadeia contendo um nmero especificado de espaos em

branco. O comprimento da cadeia # deve ser uma constante numrica.
Exemplos
BLANKS(5) = "
BLANKS(10) = "
"
"
No exemplo a seguir, so adicionados espaos em branco cadeia de caracteres abc:

"abc" + BLANKS(5) = "abc
"
BYTE( )
BYTE( ) retorna a interpretao do caractere ASCII de um byte, em uma posio
especificada no registro atual.
Use BYTE( ) para examinar o contedo de uma posio em um registro, sem precisar
definir um campo para este propsito. Se voc usar essa funo em dados EBCDIC, o
valor retornado tambm ser em EBCDIC. Voc pode ter problemas ao comparar esses
dados com os valores de caracteres.
Formato de funo
BYTE(N)
A funo BYTE( ) permite o acesso a bytes individuais no registro de entrada. O valor N

se refere posio no registro (a partir de 1), independentemente de quaisquer
definies de campo. A funo acessa o byte na posio N e retorna o contedo como
uma cadeia de caracteres isolada.
36

CDOW( )
Manual de Referncia
Exemplos
Dado um registro contendo:
10072DOE
JOHN
123188
....|....1....|....2....|....3....|....4....|
BYTE(4)= 7
BYTE(25)= H
BYTE(30)=
CDOW( )
CDOW( ) retorna o nome do dia da semana para uma data especificada.
Para exibir o dia da semana como nmero, use a funo DOW( ).
Formato de funo
CDOW(D;#)
D especifica a data.
# especifica o comprimento do campo. Para exibir nomes abreviados, especifique um
comprimento de campo mais curto.
Exemplos
Para exibir o nome do dia da semana:
CDOW(`20000801`;11) = "Tera-feira"
CDOW(`20000802`;12) = "Quarta-feira"
CDOW(`20000801`;3) = "Ter"
CHR( )
CHR( ) retorna o caractere ASCII correspondente ao valor decimal especificado.
Permite consultar qualquer caractere ASCII, especialmente os que no podem ser
inseridos diretamente pelo teclado ou que no podem ser impressos.
CHR( ) o inverso da funo ASCII( ).
Captulo 2
Funes
CLEAN( )
37
Formato da funo
CHR(N)
CHR( ) retorna o caractere ASCII correspondente ao valor decimal N. O valor de N deve

ficar entre 1 e 256.
Nota: O caractere de valor zero usado como um delimitador de cadeia pelo ACL e produz
resultados imprevisveis quando usado.
Exemplos
possvel usar CHR( ) para adicionar o smbolo monetrio libra esterlina (caractere
ASCII 163) em um campo com valores monetrios, para fins de formatao:
CHR(163)+"123,45"= "123,45"
possvel tambm, utilizar CHR( ) como parte de um teste para pesquisar a existncia
de um caractere especfico no-imprimvel em campos ou registros.
CLEAN( )
CLEAN( ) procura quaisquer caracteres invlidos em uma cadeia e os substitui, bem
como a todos os caracteres subseqentes, por espaos em branco.
Use CLEAN( ) para assegurar-se de que todos os campos contendo dados invlidos
sejam impressos corretamente. Voc tambm poder usar CLEAN( ) para isolar partes
de um campo, como o sobrenome em um campo de cliente, que inclua o nome e o
sobrenome do cliente.
Formato da funo
CLEAN(C1 <;C2>)
A funo CLEAN( ) inspeciona um campo de caracteres ou expresso,C1 da esquerda

para a direita, e busca caracteres invlidos. Se encontrar algum, CLEAN( ) substitua os
dados invlidos e o restante da cadeia por espaos em branco.
O segundo parmetro opcional C2 permite especificar valores de caracteres adicionais
que devem ser considerados invlidos para os propsitos do teste. Coloque os valores
desse parmetro entre aspas.
Aplique a funo CLEAN( ) automaticamente a todos os campos de caracteres, ativando
a preferncia Dados invlidos em branco. Para isso, selecione Editar na barra de menus,
selecione Preferncias, clique na guia [Opes numricas] e marque a caixa de seleo
Dados invlidos em branco.
38

CTOD( )
Manual de Referncia
Exemplos
CLEAN("ABC%DEF";"%")= "ABC "
CLEAN("1234,56,111,2";",") = "1234,56 "
No exemplo a seguir, # representa dados de caracteres invlidos:

CLEAN("DOE, JOHN##102891231") = "DOE, JOHN
CLEAN("DOE, JOHN##102891231"; ",")= "DOE
"
"
CTOD( )
CTOD( ) converte um caractere ou expresso numrica em uma expresso de data
vlida.
Use CTOD( ) para criar uma data para fins de comparao com valores de campo de
data, especialmente se ela no for uma constante. Por exemplo, para identificar todas as
datas antes de uma determinada data, voc pode usar o teste:
DATE<CTOD(ano+ms+dia)
Nota: O ACL usar uma data inicial de 1 de janeiro de 1900 para determinar o valor de
data apropriado.
Esse procedimento tem sido substitudo pelo uso de constantes de data. Para obter mais
informaes, consulte Datas na pgina 293 do Guia do Usurio do
ACL para Windows.
Formato da funo
CTOD(C|N <;C>)
A funo CTOD( ) (abreviao de Caractere para Data) converte a cadeia de caracteres ou valores numricos em datas vlidas. CTOD( ) o nome da funo padro para
muitos outros softwares. Diferente de outros pacotes de software, o ACL tambm
converte expresses numricas em datas.
Se o primeiro parmetro for um nmero, ele automaticamente convertido em uma
cadeia, antes da converso.
Captulo 2
Funes
DATE( )
39
O primeiro parmetro ser armazenado como AAAAMMDD ou AAMMDD. Se

no for, o ACL permite que voc especifique uma cadeia de formato opcional. Por
exemplo, para converter uma data juliana do formato AADDD, especifique:
CTOD(JULIAN_DATE;"AADDD")
Nota: A cadeia de formatao tem a mesma forma que Definir data e o tipo de campo de
data. Pode ser includa pontuao na cadeia a ser convertida. Como a cadeia de formatao , na realidade, uma cadeia de caracteres, ao invs de uma data, ela deve ser
delimitada por aspas duplas ou simples (e no por aspas invertidas).
Exemplos
Suponha que voc possua um arquivo de transaes de contas a receber que inclua um
campo de data de vencimento denominado Vencimento. Voc deseja exibir todas as
transaes que tenham uma data de vencimento anterior a 1 de julho de 1995. Para isso,
precisar comparar o campo Vencimento ao valor 1 de julho de 1995. Como o campo
Vencimento interpretado pelo ACL como um nmero nico, voc no poder
compar-lo a 01/07/95 ou a 950701. Dever converter 1 de julho de 1995 em outro
nmero.
Para isso, use um teste If ou um filtro, como a seguir:
Vencimento<CTOD(950701)
Todas essas expresses retornaro o valor 31 de dezembro de 1995:

CTOD("951231")
CTOD(311295;"DDMMAA")
CTOD("19951231")
CTOD("951231"; "AAMMDD")
CTOD("311295"; "DDMMAA")
CTOD(951231)
CTOD(95365; "YYDDD")
CTOD("31/12/1995"; "DD/MM/AAAA")
Supondo-se uma exibio de data MM/DD/AA:

CTOD("951220") = "12/20/95"
CTOD("DEZ2095";"MMMDDAA") ="12/20/95"
DATE( )
DATE( ) converte uma expresso de data, a data atual do sistema ou um valor de campo
de data em uma representao de cadeia de caracteres.
Use DATE( ) quando precisar exibir a data atual como um cadeia.
40

DECIMALS( )
Manual de Referncia
Formato da funo
DATE(<D>)
Se nenhum parmetro for fornecido, a data do sistema ser convertida. Caso contrrio,
a data fornecida D ser convertida.
A data retornada como uma cadeia de caracteres de 12 bytes, no formato especificado
por Set Date. Se Set Date especificar um formato mais curto que 12 bytes, o valor
retornado ser preenchido com espaos em branco. Para obter mais informaes sobre
o comando Definir Data, consulte Set (Definir) na pgina 303.
Exemplos
Usando as configuraes de data padro DD/MM/AA, uma data de sistema 22 de
novembro de 1995 e um valor de campo de data 31 de dezembro de 1995:
DATE( ) = "22/11/95 "
DATE(DATEFLD)= "31/12/95 "
DECIMALS( )
DEC( ) permite especificar o nmero de casas decimais para uma expresso numrica
ou valor de campo. Use DEC( ) quando desejar ajustar casas decimais em clculos
matemticos ou quando desejar arredondar um resultado para um determinado
nmero de casas decimais.
Formato da funo
DEC(N;#)
Onde # uma constante numrica representando casas decimais que no podem ser
alteradas de registro para registro.
DEC( ) toma o valor de uma expresso numrica N e ajusta o nmero de decimais
especificado quele especificado por #. Se o nmero de decimais estiver sendo reduzido,
o ACL arredondar o resultado.
No possvel usar a funo DEC( ) aps um clculo, a fim de reverter o arredondamento. Por exemplo, DEC(3/2;4) = 1,0000, no 1,5000.
Nota: O nmero de decimais uma constante e no possvel alter-lo durante o processo.
Exemplos
DEC(7;2) = 7,00
DEC(7,5647;3)= 7,565
Captulo 2
Funes
DIGIT( )
41
Para criar um campo de taxa de juros diria (com seis casas decimais), a partir de um
campo de taxa de juros anual, especifique:
DEC(ANNUAL_RATE;6)/365
DIGIT( )
DIGIT( ) retorna o valor superior ou inferior de um byte compactado, em uma posio
especificada no registro.
Use DIGIT( ) quando necessitar de acesso a metades individuais de bytes em aplicaes
como Unisys e NCR, as quais utilizam campos compactados alinhados em meio byte.
Formato da funo
DIGIT(N;1|2)
A funo DIGIT( ) separa as metades individuais de um byte. O primeiro parmetro

permite especificar uma posio de byte no registro e o segundo parmetro permite
especificar 1 para retornar a metade superior do byte ou 2 para retornar a metade
inferior do byte. Em ambos os casos, o valor da metade do byte retornado na forma de
um dgito entre 0 e 15.
Exemplos
Um campo compactado com o valor 123,45 (00 12 34 5C), contendo dois decimais e
iniciando na posio 10 de byte, aparece no registro de dados no seguinte formato:
UPPER (1)
Byte 10
Byte 11
Byte 12
Byte 13
42

DOW( )
LOWER (2)
Manual de Referncia
Byte 10
Byte 11
Byte 12
Byte 13
Para identificar que dgito aparece na 12 posio na metade superior do byte use:
DIGIT(12;1) = 3
Para identificar que dgito aparece na 12 posio na metade inferior do byte, use:
DIGIT(12;2) = 4
Para obter mais informaes sobre como trabalhar com dados UNISYS, consulte
Unisys na pgina 21.
DOW( )
DOW( ) retorna uma cadeia de caracteres contendo um dgito de 1 a 7, representando o
dia da semana. O dgito 1 representa o Domingo.
Para exibir o nome do dia da semana, use a funo CDOW( ).
Formato da funo
DOW(D)
Exemplo
Para exibir o dia da semana como um nmero de um nico dgito:
DOW(`19991124`) = 4
EBCDIC( )
Converte uma cadeia em caracteres EBCDIC.
Use EBCDIC( ) para converter dados de exportao para aplicativos ou plataformas
no-baseadas em ASCII, como OS/390 ou AS400.
Formato da funo
EBCDIC(C)
EBCDIC( ) converte o valor da cadeia C em EBCDIC.
Captulo 2
Funes
EFFECTIVE( )
43
Exemplo
Para criar um campo que contenha o valor EBCDIC do campo de nome, a fim de
carreg-lo em um mainframe, especifique:
EBCDIC(NAME)
EFFECTIVE( )
EFFECTIVE( ) calcula a taxa de juros anual efetiva sobre um emprstimo.
Use EFFECTIVE( ) para determinar a taxa de juros anual efetiva quando voc conhece
a taxa de juros declarada e o nmero de perodos compostos. Por exemplo, se voc sabe
que a taxa de juros cobrada por seu carto de crdito composta mensalmente, mas
quer saber qual a taxa anual equivalente, considerando os juros compostos, voc pode
usar essa funo. Para obter mais informaes, consulte Funes financeiras na
pgina 286 do Guia do Usurio do ACL para Windows.
Formato de funo
EFFECTIVE(taxa_nominal; perodos)
taxa_nominal a taxa de juros anual nominal.
perodos o nmero de perodos compostos por ano. perodos truncado em um
nmero inteiro.
Esta funo o oposto de NOMINAL( ).

O resultado ser retornado com preciso de oito casas decimais, isto , 0,12345678 ou
12,345678%.
Se voc entrar com um parmetro claramente invlido, como uma taxa de juros
negativa, o ACL retornar um erro.
Exemplo
Se voc sabe que seu carto de crdito cobra a taxa de 18%, composta mensalmente
sobre os saldos vencidos, para calcular a taxa anual efetiva, especifique:
EFFECTIVE(.18;12) = 0,19561817
Isso mostra que a taxa efetiva anual de 19,561817%.
44

EXCLUDE( )
Manual de Referncia
EXCLUDE( )
EXCLUDE( ) retorna um cadeia de comprimento varivel, excluindo os caracteres
especificados a partir do resultado.
EXCLUDE( ) o oposto da funo INCLUDE( ).
Formato da funo
EXCLUDE(C1;C2)
EXCLUDE( ) retorna um cadeia contendo os caracteres em C1, excluindo quaisquer

caracteres que apaream em C2, na mesma ordem em que aparecem em C1.
Exemplos
EXCLUDE("123 any street";"0123456789")=" any street"
Para remover uma vrgula, uma barra e um sinal numrico do campo PRODNO, especifique:
EXCLUDE(Prodno;",/#")
EXPONENT( )
EXP( ) retorna o valor exponencial (base 10) de uma expresso numrica.
Use EXP( ) para aplicaes financeiras que necessitam de clculos matemticos
complexos. EXP( ) realiza uma operao semelhante do operador de potenciao ^,
mas pode ser til em aplicaes que tambm usam a funo LOG( ).
EXP( ) o oposto da funo LOG( ).
Formato da funo
EXPONENT(N;#)
alteradas, de registro para registro.
EXP( ) retorna o valor exponencial (base 10) da expresso numrica ou valor de campo
N com # casas decimais. O valor exponencial de um nmero definido como 10 elevado
N-sima potncia. Portanto, o valor exponencial de 3 1000. O inverso de um
expoente seu logaritmo.
Exemplos
EXP(3;2) = 1000,00
EXP(4,86;6)= 72443,596007
Captulo 2
Funes
FILESIZE( )
45
Para criar um campo que seja a raiz cbica do campo X com duas casas decimais,
especifique:
EXP(LOG(X;6)/3;2)
Nota: possvel determinar a N-sima raiz dividindo o logaritmo do valor por N e

obtendo o exponencial do resultado.
FILESIZE( )
FILESIZE( ) retorna o tamanho de um arquivo.
Use FILESIZE( ) para especificar o tamanho de um arquivo em bytes ou determinar se
o arquivo existe. A funo FILESIZE( ) retorna o tamanho de um arquivo em bytes ou
1, se o arquivo no existir.
Normalmente, essa funo usada para verificar a existncia de um arquivo de forma a
controlar a execuo de um batch, ou usar o tamanho retornado para algum clculo til.
Formato da funo
FILESIZE(nome-do-arquivo)
Nome-do-arquivo o nome do arquivo cujo tamanho voc deseja determinar. Se o
arquivo estiver no mesmo diretrio que o Projeto ACL, no ser necessrio especificar
todo o caminho. Para arquivos contidos em outros diretrios, digite um caminho
relativo, como dados\nome-do-arquivo.fil, ou um caminho absoluto, como
c:\acl\dados\nome-do-arquivo.fil.
Exemplos
Para executar o batch TEST somente se o arquivo Demo.fil existir:
DO TEST IF FILESIZE("Demo.fil")>0
No Construtor de expresses possvel selecionar FILESIZE( ) na lista suspensa

Funes, com um duplo clique naquele item da lista. A funo selecionada inserida na
caixa de texto Expresso. Se o arquivo a ser dimensionado no estiver no mesmo
diretrio, voc dever inserir o caminho relativo ou absoluto para o arquivo.
FILESIZE(c:\diretrio\subdiretrio\Demo.fil)
Para exibir o tamanho de Demo.fil, no Log de comando use o comando Calcular.

Calculate FILESIZE("Demo.fil")
46

FIND( )
Manual de Referncia
FIND( )
possvel usar FIND( ) para verificar a presena de uma cadeia de caracteres em um
campo ou registro. A funo FIND( ) no distingue entre maisculos e minsculos
(localiza maisculos e minsculos), bem como caracteres ASCII e EBCDIC. FIND( )
retorna Verdadeiro se a cadeia for localizada seno, retorna Falso.
Formato da funo
FIND(C;<campo>)
FIND( ) pesquisa a cadeia C no campo especificado por campo. Se campo for omitido,
FIND( ) pesquisar a cadeia C em todo o registro.
Exemplos
FIND("New York";CITY)
FIND("New York")
Localizando caracteres em um campo

Use a funo FIND( ) para localizar qualquer cadeia de caracteres no campo especificado.
Nota: A funo FIND( ) destina-se a localizar vrios caracteres em um campo ou registro.
Como FIND( ) localiza caracteres ASCII e EBCDIC, essa funo retornar Verdadeiro
quando encontrar o equivalente hexadecimal dos caracteres ASCII ou EBCDIC.
Para pesquisar, no campo City, as empresas localizadas em Nova Iorque, faa o seguinte:
1. Clique em
(Editar filtro de exibio), na janela Exibio. O ACL exibe a caixa de
dilogo Editar filtro de exibio.
2. Digite FIND("New York";CITY) na caixa de texto Expresso.
Captulo 2
Funes
FREQUENCY( )
47
Funo FIND
Se voc acha que poder usar esse filtro novamente, digite um nome na caixa de
texto Salvar como a fim salvar o filtro para uso posterior.
3. Clique em [OK]. Como a funo retorna Verdadeiro se a cadeia for localizada e Falso
caso contrrio; o ACL filtra os registros que no contiverem New York.
Localizao de caracteres em um registro

Se voc deixar o parmetro do campo em branco, a funo FIND( ) ir procurar a
cadeia de caracteres no registro inteiro.
Por exemplo, para procurar as palavras New York em qualquer local do registro, faa
o seguinte:
1. Na janela Exibio, digite FIND("New York") na caixa de texto do filtro.
2. Clique em
(Definir filtro). O ACL pesquisa o arquivo de entrada e identifica o
registros que contm New York em qualquer local do registro.
FREQUENCY( )
FREQUENCY( ) retorna a freqncia de Benford esperada para dgitos numricos
positivos iniciais seqenciais com uma preciso de oito dgitos. Ela permite a execuo
de testes de Benford limitados para situaes especficas.
Use FREQUENCY( ) no lugar de uma anlise de Benford completa quando desejar
concentrar-se apenas em combinaes de dgitos especficas. Por exemplo, ao auditar
pedidos de indenizao de seguro que tenham limites de aprovao com valores especificados, possvel usar a funo FREQUENCY( ) para investigar valores imediatamente
inferiores ao limite de aprovao. Para investigar pedidos com valor prximo a um
48

FTYPE( )
Manual de Referncia
limite de aprovao de $ 5.000, possvel selecionar o intervalo entre $ 4.900 e $ 4.999.

Em primeiro lugar, conte o nmero total de registros e, a seguir, use um filtro para
contar os registros para os quais LEADING( ) retorna 49, e compare a proporo das
duas contagens com o valor obtido para FREQUENCY(49). Isto mais rpido que a
execuo de uma anlise completa de um arquivo de dados com um milho de registros,
e no gera um grande arquivo de dados ou entradas extensas no Log de comando.
Formato da funo
FREQUENCY(C)
C uma cadeia de caracteres consistente apenas dos dgitos de 0 a 9 e tem um valor
equivalente maior que zero. FREQUENCY( ) ignora quaisquer zeros esquerda na
cadeia de caracteres.
Nota: A especificao de cadeias maiores que seis dgitos pode resultar em valores zero. Os
clculos para cadeias maiores que seis dgitos podem exigir preciso maior que o limite do
ACL de oito casas decimais.
Exemplos
FREQUENCY("43") =0,00998422
FREQUENCY("87654321") = 0,00000000
A freqncia de 87654321 0,00000000495. O ACL calcula com uma preciso de oito

casas decimais e, portanto, retorna um valor zero.
FTYPE( )
FTYPE( ) retorna um valor para identificar um tipo de campo ou outro item.
Use FTYPE( ) para verificar tipos de campo ao executar um batch.
Formato da funo
FTYPE(C)
Se C for o nome do campo atual, o valor retornado ser C, N, L ou D maisculos, indicando que o campo do tipo caractere, numrico, lgico ou data, respectivamente.
Se C for um nome de varivel, o valor retornado ser c, n, l ou d minsculos,
indicando que o campo do tipo caractere, numrico, lgico ou data, respectivamente.
Captulo 2
Funes
FVANNUITY( )
49
Se C for o nome de um batch, b ser retornado. Da mesma forma, FTYPE( ) retorna

Y para uma definio de arquivo de entrada, w para uma rea de trabalho, i para
um ndice e r para um relatrio.
Se C no for nenhum dos acima mencionados, o valor retornado ser U (Indefinido).
Se C for um nome de campo, varivel ou batch, certifique-se de especfic-lo entre aspas
simples ou duplas.
Nota: FTYPE( ) funciona apenas com os nomes dos itens ou campos, no com seus
contedos.
Exemplos
Se Letter representa um campo de caractere e Number representa um campo
numrico:
FTYPE("LETTER") = "C"
FTYPE("NUMBER") = "N"
Se voc tiver um aplicativo padro que faa uso do campo Amount para fins de totalizao, dever certificar-se de que existe realmente um campo Amount e que seja
numrico, antes de iniciar a aplicao padro.
O batch a seguir ser executado apenas se Amount for um campo numrico:
DO STDAPP IF FTYPE("AMOUNT") = "N"
FVANNUITY( )
FVANNUITY( ) calcula o valor futuro de uma srie de pagamentos.
Use FVANNUITY( ) quando quiser determinar quanto uma anualidade acumular em
determinado perodo. O valor futuro de uma srie de pagamentos o montante total
que a srie acumular, acrescido dos juros compostos. Por exemplo, ao depositar o
mesmo montante todos os meses em sua conta bancria, o saldo final seu valor futuro,
ou seja, a soma dos depsitos acrescida dos juros compostos acumulados. Para obter
50

FVLUMPSUM( )
Manual de Referncia
mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do

ACL para Windows.
Formato da funo
FVANNUITY(taxa;perodos;valor)
taxa a taxa de juros para o perodo.
perodos o nmero total de perodos de pagamento em uma anualidade.
valor o pagamento efetuado ao final de cada perodo. Esse valor no pode mudar
durante a anualidade.
O resultado retornado com duas casas decimais.

FVANNUITY( ) presume um valor presente zero e calcula o resultado com base nos
pagamentos efetuados ao final do perodo.
Se voc entrar com um parmetro obviamente invlido, como uma taxa de juros
negativa, o ACL retornar um erro.
Exemplos
Para calcular o valor futuro que seria acumulado se voc depositasse R$ 1.000 por ms
durante um ano, com um rendimento mensal de 1%, especifique:
FVANNUITY(,01;12;1000) = 12.682,50
Para calcular o montante que voc acumularia se depositasse R$ 2.000 por ms durante
trs anos, com um rendimento anual de 7% composto mensalmente, especifique:
FVA(,07/12;36;2000) = 79.860,20
FVLUMPSUM( )
FVLUMPSUM( ) calcula o valor futuro de uma soma global, aps determinado nmero
de perodos.
Use FVLUMPSUM( ) para determinar o valor futuro de um investimento. O valor
futuro o montante total que ser acumulado, com juros compostos. Por exemplo,
quando voc deposita uma soma global em sua conta bancria e no a movimenta, o
saldo final o valor futuro. Para obter mais
52

INCLUDE( )
Manual de Referncia
Exemplos
Para localizar o valor hexadecimal do campo X que contm a cadeia 12345:
HEX(X) = "3132333435"
Para adicionar exibio um campo que seja o valor hexadecimal do campo Count,
especifique:
HEX(COUNT)
INCLUDE( )
INCLUDE( ) retorna uma cadeia de comprimento varivel, incluindo no resultado
apenas os caracteres especificados.
INCLUDE( ) o oposto da funo EXCLUDE( ).
Formato da funo
INCLUDE(C1;C2)
INCLUDE( ) retorna um cadeia contendo apenas os caracteres de C1 que aparecem em

C2, na mesma ordem que aparecem em C1.
Exemplos
INCLUDE("123 qualquer rua";"0123456789")="123"
Para criar um campo Prod que contenha apenas os dgitos do campo Prodno,
especifique:
INCLUDE(Prodno;"123456789")
INSERT( )
INSERT( ) insere caracteres ou espaos em branco em uma cadeia de caracteres, em
qualquer posio.
Use INSERT( ) a fim de normalizar dados para formatao, para correspondncia de
duplicidades e para os comandos Associar e Relacionamentos, que exigem campos
idnticos.
Por exemplo, os nmeros de pea em um arquivo podem estar em um formato 12345
e em outro arquivo, 12-345. possvel usar INSERT( ) para inserir um hfen (-) na
posio 3.
52

INCLUDE( )
Manual de Referncia
Exemplos
Para localizar o valor hexadecimal do campo X que contm a cadeia 12345:
HEX(X) = "3132333435"
Para adicionar exibio um campo que seja o valor hexadecimal do campo Count,
especifique:
HEX(COUNT)
INCLUDE( )
INCLUDE( ) retorna uma cadeia de comprimento varivel, incluindo no resultado
apenas os caracteres especificados.
INCLUDE( ) o oposto da funo EXCLUDE( ).
Formato da funo
INCLUDE(C1;C2)
INCLUDE( ) retorna um cadeia contendo apenas os caracteres de C1 que aparecem em

C2, na mesma ordem que aparecem em C1.
Exemplos
INCLUDE("123 qualquer rua";"0123456789")="123"
Para criar um campo Prod que contenha apenas os dgitos do campo Prodno,
especifique:
INCLUDE(Prodno;"123456789")
INSERT( )
INSERT( ) insere caracteres ou espaos em branco em uma cadeia de caracteres, em
qualquer posio.
Use INSERT( ) a fim de normalizar dados para formatao, para correspondncia de
duplicidades e para os comandos Associar e Relacionamentos, que exigem campos
idnticos.
Por exemplo, os nmeros de pea em um arquivo podem estar em um formato 12345
e em outro arquivo, 12-345. possvel usar INSERT( ) para inserir um hfen (-) na
posio 3.
Captulo 2
Funes
INTEGER( )
53
Formato da funo
INSERT(C1;C2;N)
INSERT( ) retorna uma cadeia onde a cadeia C2 inserida na cadeia C1, na posio N. Se
N for maior que o comprimento da cadeia C1, a cadeiaC2 colocada no final da cadeia
C1. Se N for menor ou igual a 1, a cadeia C2 colocada na frente da cadeia C1.
Exemplos
INSERT("abcde";"XXX";2) = "aXXXbcde"
INSERT("abcde";"XXX";8) = "abcdeXXX"
INSERT("abcde";"XXX";0) = "XXXabcde"
INTEGER( )
INT( ) retorna o valor inteiro de uma expresso numrica ou valor de campo.
Use INT( ) para ignorar ou isolar a parte fracionria de uma expresso.
Formato da funo
INTEGER(N)
A funo INT( ) retorna o valor inteiro da expresso numrica ou valor do campo N.

Nota: Por definio, nmeros aps o sinal de decimal so truncados.
Nota: Alguns outros pacotes de software definem o INT de um valor negativo como sendo
o prximo valor mais baixo, isto , INT(-7,9) = -8. No o que acontece com o ACL, j que
os valores negativos tendem a significar crditos contbeis em dados financeiros e no
valores verdadeiramente negativos.
Exemplos
INT(7,9)= 7
INT(-7,9)= -7
Para criar o campo Cents, que a poro do campo Amount em que voc est
interessado, especifique:
Amount - INT(Amount)
ISBLANK( )
ISBLANK( ) retorna Verdadeiro ou Falso, dependendo se uma cadeia consiste inteiramente de espaos em branco.
54

LAST( )
Manual de Referncia
Use ISBLANK( ) para localizar registros com ausncia de informaes. Esta funo
pesquisa entradas em branco em campos que no deveriam cont-las e foi prevista para
testes lgicos.
Formato da funo
ISBLANK(C)
ISBLANK( ) retorna Verdadeiro se a cadeia C consistir inteiramente de espaos em

branco e Falso caso contrrio. ISBLANK( ) identifica apenas espaos em branco reais
em dados possveis de serem impressos, no caracteres invlidos que aparecem como
espaos em branco em uma exibio.
ISBLANK( ) pode no retornar resultados teis com campos de caracteres que
contenham caracteres nulos (zeros binrios). O ACL e algumas linguagens de programao usam o caractere nulo para indicar o final de uma cadeia. Em conseqncia,
ISBLANK( ) no faz a leitura de qualquer dado de caractere que venha a seguir de um
caractere nulo, incluindo espaos em branco.
Exemplos
ISBLANK(" A") = F
ISBLANK(" ") = T
ISBLANK("") = T
LAST( )
LAST( ) retorna um nmero especificado de caracteres a partir do final de uma cadeia.
Formato da funo
LAST(C;#)
Onde C a cadeia de origem e # uma constante numrica.

LAST( ) retorna uma cadeia contendo os ltimos # caracteres do final da cadeia C.
Quando os caracteres no forem suficientes para preencher a cadeia resultante, so
adicionados espaos em branco esquerda da cadeia.
Exemplos
LAST("abcdefghi";5) = "efghi"
LAST("abcdefghi ";5) = "ghi "
LAST("abc";6) = "
abc"
Captulo 2
Funes
LEADING( )
55
LEADING( )
LEADING( ) retorna uma cadeia de caracteres contendo um nmero especificado de
dgitos iniciais.
Use LEADING( ) para filtrar elementos que no sejam dgitos significativos, como zeros
esquerda, dgitos no-numricos e pontuao como sinais decimais ou cifro.
Formato da funo
LEADING(N;#)
# deve ser um nmero inteiro positivo, maior que 0.
Exemplos
Se um campo numrico chamado Amount contiver o valor $-6.234,56, o valor
analisado :
LEADING(Amount;3) = "623"
Se um campo numrico chamado Amount contiver o valor $0,00, o valor analisado :

Se um campo numrico chamado Amount contiver o valor $3,55, o valor analisado :

LENGTH( )
LENGTH( ) retorna o comprimento de uma cadeia especfica.
Formato da funo
LENGTH(C)
LENGTH( ) conta o nmero de caracteres em C e retorna a este valor.

Nota: O ACL conta quaisquer espaos em branco direita (finais) no comprimento. Se
voc no deseja que os espaos em branco direita sejam contados, use a funo TRIM( )
para remov-los.
Para obter mais informaes, consulte TRIM( ) na pgina 84.
Por definio, o comprimento de um campo de caractere sempre constante.
56

LOGARITHM( )
Manual de Referncia
Exemplos
LENGTH("ABCDE")=5
Para criar um campo que contenha o comprimento do campo Name sem os espaos
em branco direita, especifique:
LENGTH(TRIM(Name))
LOGARITHM( )
LOG( ) retorna o logaritmo (base 10) de uma expresso numrica ou campo de valor
com o nmero especificado de casas decimais.
LOG( ) o inverso da funo EXP( ).
Use LOG( ) para aplicativos financeiros que necessitem de clculos matemticos
complexos.
Formato da funo
LOGARITHM(N;#)
LOG( ) retorna o logaritmo comum (base 10) da expresso numrica ou valor de campo
N com # casas decimais. O logaritmo de um nmero o expoente (ou potncia) de dez
necessrio gerao do nmero. Portanto, o logaritmo de 1000 3. O inverso de um

logaritmo seu expoente.
Exemplos
LOG(1000;4) = 3,0000
LOG(72443;2)= 4,86
Para criar um campo que seja a raiz cbica do campo X com duas casas decimais,
especifique:
EXP(LOG(X;6):3;2)
Nota: A raiz N determinada dividindo-se o logaritmo do valor por N e tomando o valor

exponencial do resultado.
Captulo 2
Funes
LOWER( )
57
LOWER( )
LOWER( ) converte todos os caracteres alfabticos de uma expresso ou campo para
minsculo.
Use LOWER( ) ao procurar dados que misturam maisculo/minsculo ou que no se
conhea a forma, ou quando se deseja que os caracteres estejam em minsculo, para fins
de formatao.
LOWER( ) o inverso da funo UPPER( ).
Formato da funo
LOWER(C)
A funo LOWER( ) converte todos os caracteres alfabticos de uma cadeia C para

minsculo. Todos os caracteres no-alfabticos permanecero inalterados. Para obter
mais informaes, consulte PROPER( ) na pgina 68, que converte caracteres alfabticos em maisculo e minsculo e UPPER( ) na pgina 85, que converte caracteres
alfabticos em maisculo.
Exemplos
LOWER("ABC")= "abc"
LOWER("abc 123 DEF")= "abc 123 def"
LOWER("AbCd 12")= "abcd 12"
Para criar um campo Name com letras minsculas, especifique:

LOWER(Name)
LTRIM( )
LTRIM( ) retorna uma cadeia de comprimento varivel com todos os espaos em
branco esquerda (iniciais) removidos.
LTRIM( ) similar funo TRIM( ), que remove quaisquer espaos em branco
direita (finais) de uma cadeia e a ALLTRIM( ), que remove os espaos em branco nas
duas extremidades.
Formato da funo
LTRIM(C)
A cadeia C copiada para o resultado e quaisquer caracteres em branco direita so

omitidos.
Consulte tambm TRIM( ) na pgina 84.
58

MAP( )
Manual de Referncia
Exemplos
LTRIM("
AB C ")="AB C "
LTRIM("ABC")="ABC"
LTRIM(" A ")="A "
MAP( )
MAP( ) executa uma comparao caractere a caractere de uma cadeia de origem com
uma cadeia de formatao especificada e retorna um valor Verdadeiro ou Falso. A
cadeia de formatao pode conter quaisquer caracteres curinga, caracteres literais ou
ambos.
Use MAP( ) para executar comparaes de curinga ou literais no ACL, especialmente
para criar filtros que no estejam baseados em texto literal.
Formato da funo
MAP(C1;C2)
Onde C1 a cadeia de origem a ser comparada e C2 a cadeia de formatao.

Se C2 for maior que C1, o resultado ser Falso. Se C2 for menor, MAP( ) compara apenas
os caracteres com o comprimento de C2. Os caracteres remanescentes na cadeia C1 no
afetaro o valor retornado.
MAP( ) retorna Verdadeiro se C1 for equivalente a C2. Ela retorna Falso se C1 no for
equivalente a C2.
A cadeia de formatao (C2) pode conter caracteres literais, que sero correspondentes
somente se o mesmo caractere existir na mesma posio da cadeia de origem. Tambm
possvel especificar os seguintes tipos de caracteres:
Use:
Para:
X,x
Corresponder a qualquer caractere alfabtico (a-z, A-Z, caracteres

europeus)
Corresponder a qualquer nmero (0-9)
Corresponder a qualquer caractere diferente de branco
Corresponder a qualquer caractere
Especificar se o caractere a seguir literal, independente de seu valor.
O tipo de caractere alfabtico no distingue entre maisculo e minsculo. Use X ou

x.
Captulo 2
Funes
MASK( )
59
Os espaos em branco podem ser inseridos como espaos em branco, sem \ na frente.
Use \ antes de qualquer caractere de formatao que deve estar literalmente presente
na cadeia de formatao. Por exemplo, para especificar X como literal, insira \X na
cadeia de formatao. Para especificar uma barra invertida como literal, insira \\.
Uma nica \ como o ltimo caractere na cadeia C2 ser ignorada.
Exemplos
MAP("ABC123";"xxx999") = T
MAP("ABC123";"XX999") = F
MAP("A bc123";"X XX999") = T
MAP("A bc123";"XXX999") = F
MAP("ABC123";"ABC999) = T
MAP("ABC123";"XXC999") = T
MAP("WXY123";"W\XY999") = T
MAP("ABC123";"XXX 9999") = F
MAP("A1 B23";"XXXX") = F
MAP("A1 B23";"!!!!") = F
MASK( )
MASK( ) extrai bits individuais do primeiro byte de uma expresso com caracteres.
Use MASK( ) para identificar padres de bits especficos em um byte de dados.
Formato da funo
MASK(C1;C2)
MASK( ) executa uma operao AND lgica orientada por bits nos primeiros caracteres
de C1 e C2 retornando uma cadeia de um caractere de comprimento. Se qualquer
parmetro for maior que um byte, os caracteres seguintes sero ignorados. O uso
normal ter o byte em questo como C1 e um valor de mscara como C2.
Uma operao AND orientada por bits compara dois bytes, um bit por vez. O resultado
para cada posio de bit ser 1, se os dois bits correspondentes forem 1. Caso contrrio,
o resultado ser 0 para aquele bit.
Exemplo
MASK("A";CHR(15)) = CHR(1)
(onde A = 65 = 01000001, 15 = 00001111, A e 15 = 00000001)
60

MATCH( )
Manual de Referncia
MATCH( )
MATCH( ) compara uma expresso ou valor de campo de qualquer tipo com uma srie
de expresses especificadas ou valores de campo, a fim de determinar se existe no
mnimo uma correspondncia. O valor retornado ser verdadeiro ou falso.
Use MATCH( ) para eliminar a necessidade de repetir argumentos em um teste.
Formato da funo
MATCH(valor_da comparao;teste 1;teste 2 <;teste 3...>)
MATCH( ) retorna um valor Verdadeiro ou Falso, dependendo do valor da comparao

ser igual a qualquer dos testes subseqentes. Qualquer nmero de testes pode ser
includo, cada um deles consistindo em uma constante, valor de campo ou expresso.
Os testes podem ser de qualquer tipo (caractere, numrico ou lgico), desde que sejam
de tipo igual. Por exemplo:
IF LOC = 7 OR LOC = 9 OR LOC = 13 OR LOC = 21 OR LOC = 44
pode ser substitudo por:

IF MATCH(LOC; 7; 9; 13; 21; 44)
Exemplos
MATCH(7;1;3;5;7;9) = T
porque 7 est includo em 1, 3, 5, 7, 9

MATCH(7;2;4;6;8;10) = F
porque 7 no est includo em 2, 4, 6, 8, 10

MATCH('BILL';'JOHN';'ANDY') = F
Se as localizaes 01, 02, e 22 representam sua diviso de pesquisa, a fim de recriar um

filtro para Research (Pesquisa) que exclua todos os outros departamentos, especifique:
MATCH(LOC;"01";"02";"22")
Captulo 2
Funes
MAXIMUM( )
61
Para extrair todos os registros para a diviso de pesquisa, entre com Research na caixa
de texto de condio.
Extrair registros
Condio
Nome do arquivo extrado
MAXIMUM( )
MAXIMUM( ) retorna o maior de dois nmeros.
MAXIMUM( ) o oposto da funo MINIMUM( ).
62

MINIMUM( )
Manual de Referncia
Formato da funo
MAXIMUM(N1;N2)
Se N1 for maior que N2, MAXIMUM( ) retorna N1. De outra forma, retorna N2.
Se o nmero de decimais nos dois parmetros for diferente, o resultado ser ajustado
para o maior nmero de decimais.
Exemplos
MAX(4;7)= 7
MAX(7,5;4)= 7,5
MAX(7;4,55)= 7,00
Se voc tiver um arquivo de contas vencidas, para criar um campo Juros_a_pagar com
um valor mnimo de R$1,00 ou mais, especifique:
MAXIMUM(Saldo * Taxa_anual;1)
Se o saldo multiplicado pela taxa de juros for menor que 1 real, MAX( ), retorna 1.
Seno, MAX( ) retorna o valor dos juros calculados.
MINIMUM( )
MINIMUM( ) retorna o menor dos dois nmeros especificados.
MINIMUM( ) o oposto da funo MAXIMUM( ).
Formato de funo
MINIMUM(N1;N2)
Se N1 for menor que N2, MINIMUM( ) retorna N1. Seno, retornar N2.
Se o nmero de decimais nos dois nmeros for diferente, MINIMUM( ) ajustar o
resultado ao maior nmero de decimais.
Exemplos
MIN(4;7)= 4
MIN(7,5;4)= 4,0
MIN(7;4,55) = 4,55
Em um arquivo de estoque, para criar um campo que contenha o menor preo de custo
e de venda, especifique:
MINIMUM(Custo;Venda)
Captulo 2
Funes
MOD( )
63
MOD( )
MOD( ) divide dois nmeros e retorna o resto.
Use MOD( ) para testar se dois nmeros divididos tm resultado exato ou para isolar o
resto de um clculo de diviso.
Formato da funo
MOD(N1;N2)
MOD( ) retorna o resto da diviso de N1 por N2. O resto tem o mesmo nmero de
decimais que o maior dos dois nmeros.
Exemplos
MOD(93;10)= 3
MOD(66;16,00)= 2,00
MOD(53,45;10)= 3,45
Em um arquivo de folha de pagamento, para definir um campo que mostre o nmero de

meses desde o ltimo aniversrio da admisso, especifique:
MOD(Meses_de_Servio;12)
NOMINAL( )
NOMINAL( ) calcula a taxa de juros nominal anual de um emprstimo.
Use NOMINAL( ) para determinar a taxa de juros nominal anual, considerando a taxa
efetiva e o nmero de perodos compostos por ano. Por exemplo, se voc sabe qual a
taxa efetiva anual de seu carto de crdito, mas deseja saber qual a taxa realmente
utilizada para calcular os juros mensais, deve usar essa funo. Para obter mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
NOMINAL(taxa_efetiva; perodos)
taxa_efetiva a taxa de juros anual efetiva.
perodos o nmero de perodos compostos por ano. perodos truncado para um
inteiro.
O resultado ser retornado para oito casas decimais, 0,12345678 ou 12,345678%.
Essa funo o oposto de EFFECTIVE( ).
64

NPER( )
Manual de Referncia
negativa, o ACL retorna um erro.
Exemplo
Se voc sabe que a taxa efetiva anual de seu carto de crdito de 19,56%, para calcular
a taxa usada mensalmente, especifique:
NOMINAL(0,1956;12) = 0,17998457
Isso mostra que a taxa mensal de 18%.
NPER( )
NPER( ) calcula o nmero de perodos necessrios para liquidar um emprstimo.
Use NPER( ) para determinar quanto tempo ser necessrio para reembolsar uma
dvida. Por exemplo, se voc estiver pagando R$500 por ms pelo financiamento de seu
carro, poder usar essa funo para saber quando a dvida ser liquidada. Para obter
ACL para Windows.
Formato da funo
NPER(taxa;pagamento;montante)
taxa a taxa de juros por perodo.
pagamento o pagamento efetuado a cada perodo.
montante o montante em que os pagamentos se baseiam.
NPER( ) presume que os pagamentos so efetuados no final do perodo.

O resultado retornado com duas casas decimais. Por exemplo, 8,33 perodos
indicariam que o saldo devedor aps oito perodos de, aproximadamente, um tero de
um pagamento.
Exemplo
Para calcular o nmero de perodos necessrios para o reembolso de um emprstimo de
1.000 com pagamentos mensais de 50 a 8%:
NPER(,08/12;50;1000) = 21,54
Isso mostra que o emprstimo ser reembolsado em 22 meses.
Captulo 2
Funes
OCCURS( )
65
OCCURS( )
OCCURS( ) conta o nmero de vezes que uma cadeia de caracteres ocorre em outra
cadeia de caracteres.
Voc pode utilizar OCCURS( ), por exemplo, para pesquisar quantas vezes New York
ocorre em um campo de endereo.
Formato da funo
OCCURS(C1;C2)
OCCURS( ) retorna o nmero de vezes em que a cadeia C2 ocorre na cadeia C1.

Nenhuma das comparaes distingue entre maisculas e minsculas.
Exemplos
OCCURS("abc/abc/a";"ab") = 2
OCCURS("abc/abc/a";"a") = 3
OFFSET( )
OFFSET( ) ajusta a posio inicial de um campo no registro atual.
Use OFFSET( ) para processar dados de ocorrncia varivel, como aqueles definidos
com a clusula OCCURS do COBOL. possvel tambm, utilizar OFFSET( ) em estruturas de registro muito complexas (como arquivos SMF da IBM), nas quais um bloco de
dados tem uma posio inicial varivel ou em um arranjo que contenha uma matriz
tendo um nmero varivel de valores.
Formato da funo
OFFSET(F;N)
A funo OFFSET( ) desloca o incio de um campo em N posies, onde N qualquer

expresso numrica positiva vlida.
Nota: Cuidado ao usar a funo OFFSET( ) com campos condicionais, porque os campos
mencionados no teste If tambm sero deslocados.
66

PACKED( )
Manual de Referncia
Exemplos
Considerando o registro 01234567890 e um campo numrico X, iniciando na posio
1 com um comprimento de 3 e nenhuma casa decimal:
X = 12
OFFSET(X;1) = 123
OFFSET(X;6) = 678
Se um registro contiver um campo de comprimento varivel seguido por outro campo

X, use OFFSET( ) para definir a localizao do campo. Suponha que o campo L seja o
comprimento do campo varivel e que j tenha usado a janela Definio de arquivo de
entrada, para definir o campo X, iniciando na posio 54 se L for zero. Para ler o
contedo do campo X, defina o seguinte campo:
OFFSET(X;L)
PACKED( )
PACKED( ) converte um nmero em um tipo de campo compactado com comprimento
especificado.
Use PACKED( ) para criar dados numricos em formato compactado. Isso pode ser
necessrio ao se criar dados a serem lidos por aplicaes externas. Para obter mais informaes sobre o tipo de campo compactado, consulte Packed (Compactado) na
pgina 18.
Consulte UNSIGNED( ) na pgina 85 para um mtodo alternativo para converso de
dados numricos.
Formato da funo
PACKED(N1;#)
PACKED( ) converte N1 em dados tipo PACKED com o comprimento, em bytes, especificado por #. Se # for muito pequeno para armazenar todos os dgitos de N1, os dgitos
significativos so truncados.
Nota: Como a sada a partir dessa funo no pode ser impressa, voc deve inclu-la
normalmente apenas na criao de um arquivo. Uma exibio no mostrar os dados,
como era de se esperar.
Captulo 2
Funes
PMT( )
67
Exemplos
PACKED(75;3)= 00075C (hex)
PACKED(7,5;3)= 00075C (hex)
PACKED(-12,456;6)= 00000012456D (hex)
PACKED(-12,456;2)= 456D (hex)
Para criar um campo de 8 bytes contendo o salrio de cada funcionrio como um

nmero PACKED a fim de carreg-lo para um mainframe, especifique:
PACKED(SALARIO;8)
PMT( )
PMT( ) calcula o pagamento peridico necessrio para liquidar uma dvida.
Use PMT( ) a fim de determinar o pagamento necessrio para liquidar um investimento
ou emprstimo, presumindo pagamentos constantes e uma taxa de juros fixa. Por
exemplo, se voc pegar um emprstimo, poder usar essa funo para determinar o
montante dos pagamentos. Para obter mais informaes, consulte Funes financeiras na pgina 286 do Guia do Usurio do ACL para Windows.
Formato da funo
PMT(taxa;perodos;montante)
montante o valor presente; o montante do investimento a ser liquidado.
O pagamento retornado por PMT( ) inclui apenas o principal e os juros, e presume que
os pagamentos sero efetuados ao final de cada perodo.
Exemplo
Se voc deseja determinar os pagamentos mensais necessrios para liquidar um
emprstimo de R$10.000 em 24 meses, a uma taxa de 8% composta mensalmente,
especifique:
PMT(,08/12;24;10000) = 452,27
68

PROPER( )
Manual de Referncia
PROPER( )
PROPER( ) converte caracteres alfabticos em uma cadeia ou campo em caracteres
misturados maisculo/minsculo, conforme necessrio para uma representao de
nome prprio.
PROPER( ) til para tarefas como produo de cartas de confirmao.
Formato da funo
PROPER(C)
A funo PROPER( ) toma uma nica cadeia de caracteres (C) e a converte em maisculas e minsculas do modo apropriado para representar nomes prprios. PROPER( )
usa a regra de que o primeiro caractere alfabtico convertido em letra maiscula e os
caracteres seguintes convertidos em minsculas. Consulte tambm, UPPER( ) na
pgina 85 e LOWER( ) na pgina 57, que converte caracteres alfabticos em
maisculo e minsculo, respectivamente.
Exemplos
PROPER("JOHN DOE")= "John Doe"
PROPER("john doe")= "John Doe"
PROPER("123 AnyWhere St.")= "123 Anywhere St."
PROPER("BILL O'HARA")= "Bill O'Hara"
PVANNUITY( )
PVANNUITY( ) calcula o valor presente de uma srie de pagamentos.
Use PVANNUITY( ) quando quiser determinar o valor presente de uma srie de
pagamentos futuros. Por exemplo, ao tomar um emprstimo em dinheiro, o montante
do emprstimo o valor presente para o credor. Para obter mais informaes, consulte
Funes financeiras na pgina 286 do Guia do Usurio do ACL para Windows.
Formato da funo
PVANNUITY(taxa; perodos; valor)
valor o pagamento efetuado ao final de cada perodo e no pode mudar durante a
anuidade.
Captulo 2
Funes
PVLUMPSUM( )
69
PVANNUITY( ) presume um valor futuro zero e calcula o resultado com base nos
pagamentos efetuados ao final do perodo.
Exemplo
A uma taxa de juros anual de 8%, para calcular o valor a receber de R$500 ao ms
durante os prximos vinte anos, especifique:
PVA(0,08/12;12*20;500) = 59.777,15
PVLUMPSUM( )
PVLUMPSUM( ) calcula o valor presente de uma soma global a ser paga em vrios
perodos.
Use PVLUMPSUM( ) para determinar o valor presente de um montante a ser recebido
ou pago no futuro. O valor presente o montante de um pagamento com vencimento
futuro, com base em uma taxa de juros presumida. Por exemplo, se voc deve dinheiro
em uma data futura, o valor presente o montante necessrio a ser depositado agora no
banco, com juros compostos, para cobrir a dvida no vencimento. Para obter mais informaes, consulte: Funes financeiras na pgina 286 do Guia do Usurio do
ACL para Windows.
Formato da funo
PVLUMPSUM(taxa;perodos;montante)
perodos o nmero total de perodos.
valor o pagamento efetuado ao final de cada perodo.

Se voc entrar com um parmetro obviamente invlido, o ACL retorna um erro.
Exemplo
Presumindo uma taxa de juros anual de 11%, composta mensalmente, o valor presente
de $10.000 a pagar em trs anos :
PVLUMPSUM(0,11/12;3*12;10000) = 7.200,05
70

RAND( ) ou RND( )
Manual de Referncia
RAND( ) ou RND( )
RAND( ) ou RND( ) retorna um nmero aleatrio entre zero e o valor de uma
expresso numrica especificada ou valor de campo.
Use RAND( ) quando voc precisar gerar um nmero aleatrio para usar dentro ou fora
do ACL.
Formato da funo
RANDOM(N) ou RND(N)
RAND( ) ou RND( ) retorna um nmero aleatrio maior ou igual a 0 e menor que a

expresso numrica ou valor do campo N. O nmero aleatrio gerado tem o mesmo
nmero de decimais que N.
Nota: Se voc usar RAND( ) ou RND( ) duas vezes consecutivamente com o mesmo valor,
sero produzidos resultados diferentes. A seqncia no ser realimentada antes que o
ACL gere o segundo resultado. Para realimentar a seqncia, use o comando Random.
Exemplos
RAND(1000,00)= 278,61
RND(10000)= 3781
RATE( )
RATE( ) calcula a taxa de juros por perodo, implcita em uma anualidade.
Use RATE( ) para determinar a taxa de juros que est sendo paga em uma anualidade.
Por exemplo, se voc tem a opo de fazer leasing ou de comprar determinado produto,
pode usar essa funo para determinar a taxa de juros implcita no leasing. Para obter
ACL para Windows.
Formato da funo
RATE(perodos; pagamento; montante)
perodos o nmero total de perodos.
pagamento o pagamento efetuado a cada perodo.
montante o montante no qual os pagamentos se baseiam.
RATE( ) presume que os pagamentos sejam efetuados no final do perodo.
Captulo 2
Funes
RECLEN( )
71
O resultado retornado com oito casas decimais, ou seja, 0,12345678 ou 12,345678%.

Exemplo
Para calcular a taxa implcita em um emprstimo de $8.000 para liquidao em quatro
anos, com pagamentos mensais de R$200, especifique:
RATE(48;200;8000) = 0,00770147
Essa a taxa mensal porque o perodo mensal. A taxa anual de 0,0077*12, que corresponde a 9,24% compostos mensalmente, ou a uma taxa efetiva anual de 9,64% (usando
a funo EFFECTIVE( )).
RECLEN( )
RECLEN( ) retorna o comprimento do registro atual.
Use RECLEN( ) para testar registros pequenos ou para registros de um comprimento
determinado. especialmente til com arquivos (relatrio) CR/LF, porque fornece um
modo fcil para examinar os comprimentos dos registros.
Formato da funo
RECLEN()
RECLEN( ) retorna o comprimento do registro atual.

Para obter mais informaes sobre como determinar o registro atual, consulte
RECNO( ) na pgina 72.
Para registros de comprimento fixo, o resultado ser uma constante (o comprimento do
registro). Para registros de comprimento varivel, o resultado alterado para cada
registro.
72

RECNO( )
Manual de Referncia
Exemplo
Para extrair todos os registros cujo comprimento exatamente 110 (presumindo que
esse o tipo de registro de seu interesse), especifique:
RECLEN( ) = 110
Extrair registros
Condio
Nome de arquivo extrado
RECNO( )
RECNO( ) retorna o nmero de registro lgico atual, contando a partir de 1.
Use RECNO( ) para gravar nmeros de registro em um arquivo, ou quando examinar
um arquivo pela primeira vez para determinar a localizao relativa de um determinado
registro.
Formato da funo
RECNO()
RECNO( ) retorna o nmero do registro lgico atual. Se o arquivo no estiver indexado,

RECNO( ) inicia com um valor 1 e incrementado de um para cada registro no arquivo.
Os nmeros de registro lgico e fsico so idnticos.
Se o arquivo estiver indexado, RECNO( ) funciona de modo semelhante, mas em uma
ordem lgica e no fsica. Se os comandos Seek ou Find forem usados, o nmero do
registro ser redefinido para 1, aps a execuo desses comandos.
Captulo 2
Funes
REMOVE( )
73
Exemplo
Para o registro 99:
RECNO() = 99
REMOVE( )
REMOVE( ) retira os caracteres indesejados de uma cadeia de caracteres ou valor de
campo.
Use REMOVE( ) para normalizar campos de dados que no tm um formato consistente, como campos de endereo. Essa funo tambm til para remover pontuaes
ou outras informaes invlidas de campos editados incorretamente, ou que no
tiveram edies de entrada aplicadas. REMOVE( ) pode ser necessria antes da
execuo subseqente dos comandos Ordenar ou Associar ou para tornar os dados
mais regulares para formatao ou correspondncia de duplicidades.
Nota: Esta funo foi substituda pelas funes INCLUDE( ) e EXCLUDE( ). Ainda est
disponvel na verso atual para compatibilidade com verses anteriores do ACL para
Windows.
Formato da funo
REMOVE(C1;C2)
A funo REMOVE( ) remove os caracteres desnecessrios da cadeia C1, retendo

apenas os caracteres especificados C2. Essa funo semelhante funo CLEAN( )
quanto ao objetivo, mas o funcionamento bem diferente. CLEAN( ) preenche o
restante de um campo com espaos em branco, enquanto REMOVE( ) move quaisquer
caracteres vlidos para o lado esquerdo do campo, preservando sua ordem e adicionando espaos em branco ao resultado final, a fim de que o comprimento seja o mesmo
de C1.
Suponha que voc tenha um arquivo de transaes de estoque, no qual o nmero do
produto, Prodno, no tenha contedo de campo limpo. Voc deseja classificar o
arquivo em nmeros de produto similares. O arquivo pode conter AB/123Q, AB123
Q e AB 123-Q, todos referindo-se ao mesmo produto, mas ordenados de forma
diferente. A funo REMOVE( ) permite que o campo seja normalizado, para que o
comando Ordenar possa funcionar corretamente, convertendo cada um dos exemplos
acima em AB123Q.
Para obter mais informaes sobre a incluso e excluso de caracteres em uma cadeia,
consulte INCLUDE( ) na pgina 52 e EXCLUDE( ) na pgina 44.
74

REPEAT( )
Manual de Referncia
Exemplos
REMOVE("ABC 123 XX4"; "ABC123")= "ABC123"
REMOVE("ABC 123 XX4"; "ABCX123")= "ABC123XX"
REMOVE("ABC 123 XX4"; "1234567890")= "1234"
Para criar um campo para classificao ou correspondncia que contenha apenas os

nmeros de um campo de cdigo de produto, especifique:
REMOVE(Prodno;"123456789")
REPEAT( )
REPEAT( ) retorna uma cadeia que repete um valor constante por um nmero especificado de vezes.
Use REPEAT( ) para inicializar uma varivel com valores constantes ou espaos em
branco, ou para configurar um valor padro para um campo calculado. til para
aplicativos de programao avanada.
Formato da funo
REPEAT(C;#)
REPEAT( ) retorna uma cadeia na qual a cadeia C repetida um determinado nmero

de vezes especificado por #, onde # uma constante numrica fixa. O comprimento
mximo da cadeia retornada o comprimento da cadeia C multiplicado por #.
Exemplos
REPEAT("ABC";3) = "ABCABCABC"
REPEAT("0";9) = "000000000"
REPLACE( )
REPLACE( ) substitui todas as instncias de uma cadeia de caracteres especificada por
uma nova cadeia de caracteres.
Use REPLACE( ) para normalizar campos de dados com formatos inconsistentes, como
campos de endereo, ou para substituir informaes invlidas em campos com edio
deficiente. Tambm possvel usar REPLACE( ) para obter consistncia na formatao,
para correspondncia de duplicidades e para os comandos Associar e Relacionamentos,
que exigem campos idnticos.
Tambm possvel usar REPLACE( ) para remover uma cadeia de caracteres especfico
de uma cadeia de origem, substituindo-a por uma cadeia de caracteres vazios().
Captulo 2
Funes
REPLACE( )
75
Formato da funo
REPLACE(C1;C2;C3)
Onde C1 a cadeia de origem, C2 a cadeia a ser substituda e C3 a nova cadeia. As

comparaes de caracteres distinguem maisculas de minsculas.
REPLACE( ) retorna uma cadeia de comprimento fixo no qual cada ocorrncia de C2
em C1 substituda por C3. O ACL aumenta, automaticamente, o comprimento do
campo, a fim de acomodar uma nica substituio. O comprimento mximo do campo
maior entre o comprimento de C1 ou o comprimento de (C1 - C2 + C3). Se a cadeia
resultante for menor que a cadeia de origem C1, espaos em branco so adicionados ao
final da cadeia, para compensar a diferena.
No entanto, com diversas substituies, o novo contedo do campo de dados pode
exceder o comprimento do campo. Quando isso acontece, o ACL trunca dados no final
do campo. A fim de evitar perda de informaes, assegure-se de que o campo suficientemente longo para acomodar um possvel incremento no comprimento dos dados. Na
seo seguinte, so descritos dois mtodos para incremento do comprimento dos
campos.
Exemplos
REPLACE ("abcdefg";"bcd";"12345") = "a12345efg"
REPLACE("Road";"Road";"Rd.") = "Rd. "
REPLACE("abc";"b";"") = "ac "
No exemplo a seguir, a cadeia retornada truncada, porque diversas substituies

tornaram a cadeia C3 retornada maior que a cadeia C2:
REPLACE("abc/abc/abc";"b";"12") = "a12c/a12c/a1"
Neste caso, o ACL incrementou o comprimento do campo de 11 bytes para 12 bytes, a

fim de permitir uma substituio (11 - 1 + 2 = 12). Depois de trs substituies, a cadeia
retornada 2 bytes mais longa (11 - 1 + 2 - 1 + 2 - 1 + 2 = 14) e os 2 ltimos bytes da
cadeia retornada esto truncados.
Existem diversas maneiras de incrementar o comprimento do campo para acomodar o
comprimento incrementado da cadeia retornada. Um dos caminhos usar a nova
funo BLANKS( ) para adicionar espaos em branco cadeia de origem, antes de usar
REPLACE( ):
"abc/abc/abc"+BLANKS(2) = "abc/abc/abc
"
Agora use
REPLACE("abc/abc/abc ";"b";"12") = "a12c/a12c/a12c"
76

REVERSE( )
Manual de Referncia
Outra maneira de incrementar o comprimento do campo adicionar espaos ao final de

um campo, utilizando a expresso:
<campos> + "
"
REVERSE( )
REVERSE( ) inverte a ordem dos caracteres em uma cadeia.
Formato da funo
REVERSE(C)
REVERSE( ) retorna uma cadeia na qual os caracteres da cadeia C so invertidos.
Exemplo
REVERSE("ABCD E") = "E DCBA"
RJUSTIFY( )
RJUSTIFY( ) retorna uma cadeia alinhada para a direita com o mesmo comprimento
que a cadeia especificada, com todos os espaos em branco no final movidos para o
incio da cadeia.
Use RJUSTIFY( ) para alinhar um campo direita.
Formato da Funo
RJUSTIFY(C)
Exemplo
RJUSTIFY("ABC
") = "
ABC"
ROOT( )
ROOT( ) retorna a raiz quadrada de uma expresso numrica ou valor de campo. Voc
deve especificar o nmero de casas decimais no resultado.
Formato da funo
ROOT(N;#)
Captulo 2
Funes
ROUND( )
77
ROOT( ) retorna a raiz quadrada da expresso numrica ou valor de campo N com #

casas decimais. O resultado ser arredondado apropriadamente. Essa funo retornar
zero para valores negativos de N. Para executar outras funes de raiz (como raiz
cbica), consulte LOGARITHM( ) na pgina 56.
Exemplos
ROOT(100;2) = 10,00
ROOT(1000;4)= 31,6228
ROUND( )
ROUND( ) retorna um nmero inteiro arredondado de uma expresso numrica ou
valor de campo.
Use ROUND( ) sempre que desejar arredondar uma expresso para o nmero inteiro
mais prximo.
Formato da funo
ROUND(N)
ROUND( ) retorna um nmero igual expresso numrica ou valor de campo N

arredondado para o inteiro mais prximo. Essa funo arredonda para cima valores
com decimais a partir de 0,5.
Esta funo exatamente igual DECIMAL(N;0).
Exemplos
ROUND(7,2) = 7
ROUND(7,5)= 8
ROUND(-7,5)= -8
Para criar um campo igual ao saldo arredondado para o valor monetrio mais prximo,
especifique:
ROUND(Saldo)
SHIFT( )
SHIFT( ) move bits no primeiro caractere de uma expresso ou valor de campo,
esquerda ou direita, por um nmero especificado de bits.
Use SHIFT( ) em conjunto com as funes BYTE( ), CHR( ) e MASK( ) para isolar e
mover bits individuais em um registro.
78

SOUNDEX( )
Manual de Referncia
Formato da funo
SHIFT(C;N)
A funo SHIFT( ) toma o primeiro caractere de C e desloca os bits esquerda ou

direita por N bits. Ela retorna uma cadeia com comprimento de um caractere. Se C tiver
comprimento maior que 1, os caracteres adicionais sero ignorados. Se N for positivo, o
caractere ser deslocado para a esquerda; se for negativo o caractere ser deslocado para
a direita. As posies de todos os bits deslocados a partir de qualquer extremidade so
preenchidas com zeros. Se N for maior que 7 ou menor que -7, o resultado ser zero
binrio, CHR(0).
Exemplos
SHIFT(CHR(22);2) = CHR(88)
00010110 torna-se 01011000

SHIFT(CHR(16);-1) = CHR(8)
00010000 torna-se 00001000

SHIFT(CHR(155);5) = CHR(96)
10011011 torna-se 01100000
SOUNDEX( )
SOUNDEX( ) retorna um valor de quatro caracteres para uma cadeia especfica, que
pode ser comparado ao valor de outra cadeia, a fim de verificar se ambas so foneticamente similares.
Esta funo til se voc deseja localizar itens com entradas em duplicidade ou itens
soletrados de forma inconsistente.
O primeiro caractere no valor representa a primeira letra na cadeia. Os prximos trs
caracteres no valor representam grupos de consoantes foneticamente similares na
cadeia. SOUNDEX( ) ignora caracteres maisculos e vogais na cadeia e utiliza apenas os
trs primeiros grupos de consoantes em argumentos longos.
Para obter um mtodo alternativo de cadeias foneticamente correspondentes, consulte
SOUNDSLIKE( ) na pgina 79.
Captulo 2
Funes
SOUNDSLIKE( )
79
Formato da funo
SOUNDEX(C)
Exemplos
SOUNDEX("Fairview Ind") = "F615"
SOUNDEX("Fairview Media") = "F615"
SOUNDEX("Fairviews Media") = "F612"
SOUNDSLIKE( )
SOUNDSLIKE( ) retorna Verdadeiro ou Falso para indicar quando duas cadeias tm
sons foneticamente parecidos.
SOUNDSLIKE( ) primeiramente converte as cadeias em cdigos de quatro caracteres,
conforme descrito em SOUNDEX( ). A seguir, compara o cdigo do SOUNDEX( ) de
cada cadeia e retorna Verdadeiro se os cdigos forem iguais e Falso se no forem iguais.
Esta funo no distingue entre maisculo e minsculo, portanto SMITH equivalente a smith.
Use SOUNDSLIKE( ) para identificar itens cujos sons sejam similares, para fins de
correspondncia.
Formato da funo
SOUNDSLIKE(C1;C2)
Exemplos
SOUNDSLIKE("Fairview Media"; "fairview ind") = T
SOUNDSLIKE("Fairviews Media"; "fairview ind") = F
Para criar um filtro que identifique todos os nomes foneticamente semelhantes a

Smith, especifique:
SOUNDSLIKE(NAME;"Smith")
SPLIT( )
SPLIT( ) divide uma cadeia de caracteres em segmentos separados por caracteres como
espaos ou vrgulas, e retorna um segmento especificado. Qualquer caractere ou cadeia
pode ser usada como separador.
80

STRING( )
Manual de Referncia
Formato da funo
SPLIT(C1;C2;N)
Onde C1 a cadeia de origem, C2 o caractere (ou a cadeia de caracteres) utilizado

como separador e N o segmento a ser retornado. SPLIT( ) retorna o segmento N. Se N
no existir ou for menor que 1, SPLIT( ) retorna uma cadeia vazia.
Os caracteres entre, mas no incluindo, dois separadores constituem um segmento.
Quando a cadeia de origem comea com um separador, o segmento a seguir chamado
de segmento dois. A comparao das cadeias distingue entre maisculo e minsculo.
Exemplos
SPLIT("abc,def,ghijkl";",";2) = "def"
SPLIT("abc,def,ghijkl";",";3) = "ghijkl"
SPLIT("abc/*def/*ghijkl";"/*";3) = "ghijkl"
SPLIT("Jane Doe";" ";2) = "Doe"
SPLIT("/abc/efg/";"/";2) = "abc"
SPLIT("abc,def,,ghi";",";3) = ""
STRING( )
STRING( ) converte uma expresso numrica ou valor de campo em uma cadeia de
caracteres.
Use STRING( ) para converter uma expresso numrica ou valor de campo em formato
de caractere para usar como um campo-chave em um comando do ACL, como Resumir
ou Associar.
Formato da funo
STRING(N;# <;C>)
STRING( ) converte a expresso numrica ou valor de campo N em uma cadeia de

comprimento #. A cadeia resultante ter um sinal de negativo esquerda (inicial) se N
for negativo e tem o mesmo nmero de casas decimais que N (a menos que seja especificado pelo formato ideal C, como discutido abaixo).
Voc pode especificar um formato numrico opcional como um terceiro parmetro,
para formatar o resultado numrico da funo. Certifique-se de que seja uma expresso
com caracteres vlida.
Para obter detalhes sobre formatao, consulte Campos numricos na pgina 157 do
Captulo 2
Funes
SUBSTRING( )
81
Se a cadeia resultante for menor que #, caracteres em branco sero adicionados

esquerda. Se a cadeia resultante for maior que #, caracteres esquerda sero truncados
sem notificao comeando com o sinal de menos, se houver algum.
STRING( ) o oposto de VALUE( ).
Exemplos
STRING(125,2;7) = " 125,2"
STRING(-125,2;4) = "25,2"
STRING(-125,2;7)= " -125,2"
Estes exemplos mostram o uso do parmetro de formato numrico opcional:

STRING(-125,2; 10; "(9.999,99)")= "(125,20)"
STRING(-125,2; 6; "(9.999,99)")= "25,20)"
Para criar um campo que converta o campo PACKED Custo em uma cadeia de forma
que possa ser utilizada como um campo-chave, especifique:
STRING(Custo;8)
SUBSTRING( )
SUBSTR( ) retorna uma subcadeia de uma expresso com caracteres ou valor de campo.
Use SUBSTRING( ) para isolar uma parte de uma expresso com caracteres ou valor de
campo.
Formato da funo
SUBSTRING(C;N1;N2)
SUBSTR( ) retorna uma subcadeia da expresso com caracteres ou valor de campo C. O

resultado ter N2 caracteres de comprimento, iniciando na posio N1 em C.
Exemplos
SUBSTR("ABCDEF";2;3)="BCD"
Para extrair o ano de um campo de caracteres que contm uma data no formato
MM/DD/AAAA , especifique:
SUBSTR(DATE;7;4)
82

TEST( )
Manual de Referncia
TEST( )
TEST( ) retorna Verdadeiro se uma cadeia de texto especificada for iniciada em uma
localizao de byte especificada em um registro. Caso contrrio, TEST( ) retornar
Falso.
TEST( ) ser automaticamente usado quando voc criar um filtro na janela Criar um
filtro de dados. Esta a forma mais adequada para fazer referncia funo TEST( ).
Formato da funo
TEST(N;C)
TEST( ) examina um registro a fim de verificar se uma cadeia de caracteres C comea na

posio especificada N. Neste caso, TEST( ) retorna Verdadeiro. Caso contrrio,
retornar Falso, mesmo se C aparecer em outra posio na linha.
Nota: Os parmetros em TEST( ) distinguem entre maisculas e minsculas. A especificao de DEPT no localiza Dept. Se houver uma possibilidade de mistura, utilize
primeiramente a funo UPPER( ) para converter todos os caracteres para maisculo.
Se C no for uma expresso com caracteres, certifique-se de delimit-lo por aspas.
Exemplos
Dado um registro contendo:
Dept Name: Marketing
....|....1....|....2...
TEST(5;'Dept') = T
TEST(6;'Dept') = F(Dept inicia na posio 5, no em 6)
TEST(5;'DEPT') = F(no maisculo)
Para criar um filtro que identifique cabealhos de pgina, especifique:

TEST(1;"Pgina:")
TIME( )
TIME( ) retorna a hora e data do relgio do sistema.
Use TIME( ) para determinar a hora atual ou a durao de tarefas especficas.
Captulo 2
Funes
TIME( )
83
Formato da funo
TIME()
TIME( ) retorna a hora de acordo com o relgio do sistema, no formato HH:MM:SS,

como uma cadeia de caracteres de oito bytes de comprimento. Seu valor no afetado
por contedo de campo ou registro.
Exemplo
TIME( ) = "15:38:52"
Abaixo apresentado um exemplo mais complexo. Para determinar o tempo decorrido

para um comando, voc pode converter o resultado dessa funo em um nmero de
segundos antes de iniciar o comando, repetindo o processo na concluso e subtraindo
os dois valores, da forma a seguir:
ASSIGN T=TIME()
ASSIGN T1=VALUE(SUB(T;1;2);0)*3600 + VALUE(SUB(T;4;2);0)*60
+ VALUE(SUB(T;7;2)
COMMENT ACL Comando(s) aqui
ASSIGN T=TIME()
ASSIGN T2=VALUE(SUB(T;1;2),0)*3600 + VALUE(SUB(T;4;2)*60 +
VALUE(SUB(T;7;2);0)
ASSIGN SECONDS=T2-T1
Esses clculos usam partes separadas da hora e calculam o nmero de segundos a partir
da meia-noite, antes e aps as operaes.
84

TRANSFORM( )
Manual de Referncia
TRANSFORM( )
TRANSFORM( ) inverte a ordem de exibio dos dados bidirecionais em uma cadeia de
caracteres ou campo.
Use TRANSFORM( ) para fazer com que caracteres hebraicos sejam exibidos corretamente.
Formato da funo
TRANSFORM(C)
TRANSFORM( ) identifica os dados bidirecionais e os exibe corretamente na visua

lizao, da direita para a esquerda. Todos os outros caracteres so exibidos da esquerda
para a direita.
Exemplo
TRANSFORM("ABC ZYX 123") = "ABC XYZ 123"
Onde XYZ so os nicos caracteres hebraicos/bidirecionais na cadeia.
TRIM( )
TRIM( ) retorna uma cadeia de comprimento varivel com todos os espaos em branco
finais removidos.
TRIM( ) similar funo LTRIM( ), que remove os espaos em branco esquerda
(iniciais) de uma cadeia e a ALLTRIM( ), que remove os espaos em branco em ambas
as extremidades.
Formato da funo
TRIM(C)
A cadeia C ser copiada para o resultado e os espaos em branco finais sero omitidos.
Exemplos
TRIM("
AB C ") = "
TRIM("ABC") = "ABC"
TRIM(" A ") = " A"
AB C"
Dados os dois campos Primeiro e ltimo, para criar um campo Nome no formato Last,
First, especifique:
TRIM(ltimo) + ',' + TRIM(Primeiro)
Captulo 2
Funes
UNSIGNED( )
85
UNSIGNED( )
UNSIGNED( ) converte um nmero em um tipo de dado sem sinal de um comprimento
especificado.
Use UNSIGNED( ) para criar dados numricos em formato sem sinal. Isto pode ser
necessrio ao criar dados para serem lidos por aplicaes externas. Para obter mais
informaes sobre campos sem sinal consulte Unsigned (Sem sinal) na pgina 22.
Consulte PACKED( ) na pgina 66 para obter um mtodo alternativo de converso de
dados numricos.
Formato da funo
UNSIGNED(N1;#)
UNSIGNED( ) converte N1 em dados UNSIGNED com comprimento em bytes especificado por #.

Se o comprimento for muito pequeno para armazenar o nmero inteiro, dgitos significativos sero truncados. Se N1 for negativo, o sinal de negativo ser excludo. Por
exemplo:
UNS(-12,456;6) = 000000012456 (hex)
Nota: Como a sada a partir dessa funo no pode ser impressa, voc deve inclu-la
apenas em em conjunto com a criao de um arquivo. Uma exibio no mostrar os
dados como esperado.
Exemplos
UNS(75;3)= 000075 (hex)
UNS(-75;3)= 000075 (hex)
UNS(7,5;3)= 000075 (hex)
UNS(12456;2)= 2456 (hex)
UPPER( )
UPPER( ) converte todos os caracteres alfabticos de uma expresso ou valor de campo
em maisculo.
Use UPPER( ) ao pesquisar dados com formatos maisculo/minsculo misturados ou
quando o formato for desconhecido.
Formato da funo
UPPER(C)
A funo UPPER( ) converte todos os caracteres alfabticos em C para maisculo.

Todos os caracteres no alfabticos permanecero inalterados.
86

VALUE( )
Manual de Referncia
Consulte tambm PROPER( ) na pgina 68 que converte caracteres alfabticos para

maisculo e minsculo, e LOWER( ) na pgina 57 que converte caracteres alfabticos
em minsculo.
Exemplos
UPPER("ABC")= "ABC"
UPPER("abc 123 DEF")= "ABC 123 DEF"
UPPER("AbCd 12")= "ABCD 12"
Se for necessrio usar maisculo, voc poder identificar todos os clientes chamados
Smith especificando:
UPPER(NAME) = "SMITH"
VALUE( )
VALUE( ) converte uma expresso com caracteres ou campo no equivalente numrico.
Use VALUE( ) se voc precisar converter uma expresso com caracteres ou valor de
campo para formato numrico, a fim de usar com os comandos do ACL.
VALUE( ) retorna o equivalente numrico de uma expresso com caracteres ou valor de
campo com um nmero especificado de casas decimais. Se o ajuste decimal resultar na
perda de decimais, o resultado ser arredondado.
VALUE( ) aceita nmeros em qualquer formato. possvel usar como entrada qualquer
formatao numrica aceita pelo tipo de campo de impresso, como pontuao, sinais
esquerda ou direita, e parnteses.
Se uma cadeia como 123 no contiver decimais, o ACL trata o nmero como inteiro.
Por exemplo, ao converter (123; 2), ao especificar duas casas decimais, o ACL interpreta 123 como 123,00 e no 1,23.
Compare VALUE( ) a STRING( ).
Formato de funo
VALUE(C;#)
Onde # uma constante numrica que no pode ser alterada de registro para registro.
Exemplos
VALUE("123,4-";3) = -123,400
VALUE("$123,456";2) = 123456,00
VALUE("77,45CR";2) = -77,45
VALUE(" (123.456,78)";0)= -123457
Captulo 2
Funes
VERIFY( )
87
VERIFY( )
VERIFY( ) determina se um campo contm dados vlidos e, se isso acontecer, retorna
Verdadeiro.
Como o comando Verificar e a opo de preferncia Verificar dados no permitem um
controle muito preciso, voc poder usar a funo VERIFY( ) para detectar erros em
campos individuais e prosseguir de acordo com uma situao especfica. Para obter
mais informaes, consulte Verify (Verificar) na pgina 341 e Verificar dados na
Formato da funo
VERIFY(Campo)
A funo VERIFY ( ) retorna Verdadeiro ou Falso, dependendo se o contedo do campo

contm dados vlidos. Como os campos calculados e expresses sempre contm dados
vlidos, VERIFY( ) sempre retornar Verdadeiro nestes casos.
Exemplo
Para criar um filtro que identifique dados invlidos no campo Prodno (que voc
poder usar para extrair os registros incorretos), especifique:
VERIFY(PRODNO) = F
ZONED( )
ZONED( ) converte uma expresso numrica ou valor de campo no formato de dados
ZONED do ASCII.
Use ZONED( ) para exportar dados para outras aplicaes, como programas capazes de
gerar uma sada impressa, que necessitem de arquivos de dados zonados como entrada.
Tambm possvel utilizar ZONED( ) para converter um valor numrico positivo em
um valor de caractere contendo zeros esquerda. Isto til para a normalizao de
dados em campos a ser utilizados como campos-chave. Por exemplo, se um arquivo
contm nmeros de faturas no formulrio 100 em um campo numrico, e outro arquivo
contm nmeros de faturas no formulrio 00100 em um campo de caracteres, voc
pode utilizar ZONED( ) para converter o valor numrico 100 no valor de caractere
00100. Isto permite comparar nmeros de faturas semelhantes.
Formato da funo
ZONED(nmero; comprimento)
nmero especifica a expresso numrica ou valor de campo.
88

ZSTAT( )
Manual de Referncia
comprimento especifica o comprimento do campo de caracteres ZONED do ASCII.
Este formato de dados no inclui um ponto decimal explcito. Zeros esquerda so

adicionados quando o comprimento do campo for maior que o nmero de dgitos no
campo numrico. Se o valor for negativo, o caractere mais direita exibido como }
para zero ou uma letra entre J e R para os dgitos de um a nove.
Exemplo
ZONED(-6448,95;11) = "0000064489N"
Se o nmero contm mais dgitos que o comprimento, o ACL trunca os zeros

esquerda, pois o comprimento da entrada (nmero) excede o comprimento da sada
(comprimento). Por exemplo:
ZONED(-6448,95;4) = "489N"
ZSTAT( )
ZSTAT( ) calcula a estatstica-Z para uso em muitas tarefas de soluo de problemas,
incluindo anlise digital. Ela retorna uma resposta com trs casas decimais.
Use ZSTAT( ) para avaliar a freqncia com maior probabilidade de ocorrncia de um
determinado resultado em um perodo ou categoria especificado. Quanto maior a
estatstica-Z resultante, menor a probabilidade de ocorrncia. Por exemplo, uma
estatstica-Z de 1,96 tem uma significncia de 0,05, representando a probabilidade de
uma em 20 ocorrncias, enquanto uma estatstica-Z de 2,57 tem uma significncia de
0,01, representando a probabilidade de uma em 100 ocorrncias. Para obter informaes sobre estatstica-Z, consulte um livro de estatstica.
possvel especificar os parmetros para ZSTAT( ) como nmeros ou propores:
Ao especificar ambos os parmetros como nmeros, a funo calcula a

estatstica-Z utilizando aritmtica de ponto flutuante.
Ao especificar ambos os parmetros como propores, a funo calcula a
estatstica-Z utilizando aritmtica de ponto fixo e h necessidade de usar um
multiplicador decimal para controlar o arredondamento.
Formato da funo para parmetros expressos como nmeros

ZSTAT(v1;v2;v3)
v1 representa a contagem real, como um dgito inicial ou uma combinao de dgitos
iniciais.
v2 representa a contagem prevista, como um dgito inicial ou uma combinao de
dgitos iniciais.
Captulo 2
Funes
ZSTAT( )
89
v3 representa o nmero total de itens sendo testados e deve ser um nmero inteiro
positivo maior que 0.

Exemplo com parmetros expressos como nmeros
Com base em dados dos 10 anos anteriores, voc sabe que a distribuio de reclamaes
trabalhistas por acidentes de trabalho , normalmente, muito uniforme. Em abril, maio
e junho deste ano as reclamaes cresceram cerca de 10%, atingindo uma mdia mensal
de 220, ao invs de 200. As reclamaes em julho e agosto foram ligeiramente mais
baixas, 193 e 197. O total no ano foi de 2.450. Para verificar se esses resultados altos e
baixos foram significantes, utilize a estatstica-Z.
Resultados altos. O nmero real de reclamaes de abril a junho foi de 660. O nmero
previsto para esse perodo 25% das reclamaes anuais, 2.450, ou seja, 612,5. A
estatstica-Z para essas contagens :
ZSTAT(660;612,5;2450) = 2,193
Uma estatstica Z de 1,96 tem uma significncia de 0,05 e 2,57 tem uma significncia de
0,01. Portanto, a probabilidade de que as taxas mais altas de ocorrncias sejam devidas
ao acaso fica entre 1:20 e 1:100.
Resultados baixos. O nmero real de ocorrncias em julho e agosto foi de 390. O
nmero previsto de ocorrncias para esse perodo um sexto das ocorrncias anuais de
2.450, ou seja, 408,33. A estatstica-Z para essas propores :
ZSTAT(390;408,33;2450) = 0,967
Este resultado no muito significativo. Estatsticas-Z de 1,000 ou menos so muito

comuns e podem, em geral, ser ignoradas.
Formato da funo para parmetros expressos como propores

ZSTAT(v1;v2;v3)
v1 representa a proporo real do valor sendo testado e deve estar entre 0 e 1, inclusive.
v2 representa a proporo prevista do valor a ser testado e deve ficar enre 0 e 1,
exclusive.
v3 representa o nmero total de itens sendo testados e deve ser um nmero inteiro
positivo maior que 0.

Multiplicador decimal
O ACL, de maneira geral, avalia expresses utilizando aritmtica de ponto fixo e
arredonda o resultado. Ao usar uma expresso dentro de uma expresso para v1 e v2,
voc deve especificar o nvel de preciso desejado no resultado, utilizando um multiplicador decimal. O ACL tem uma preciso de 8 dgitos, portanto, um multiplicador de
90

ZSTAT( )
Manual de Referncia
1,00000000 retornar a maior preciso possvel. Para obter mais informaes, consulte
Aritmtica de ponto fixo na pgina 284 do Guia do Usurio do ACL para Windows.
Exemplo com parmetros expressos como propores
Com base em 10 anos de dados anteriores, voc sabe que a distribuio de reclamaes
trabalhistas por acidentes por ms altamente uniforme e crescente. Em abril, maio e
junho deste ano, as reclamaes foram superiores em, aproximadamente, 10%, perfazendo uma mdia de 220 por ms, ao invs de 200. As reclamaes em julho e agosto
foram ligeiramente inferiores, de 193 e 197. O total de reclamaes do ano foi de 2.450.
Para verificar se os resultados altos e baixos foram significativos, use a estatstica-Z.
Resultados altos. O nmero real de reclamaes para abril a junho representado pela
proporo 660/2450. O nmero esperado de reclamaes para este perodo deve ser de
25% das reclamaes anuais de 2.450. A estatstica-Z para essas propores :
ZSTAT((1,00000000*660/2450);0,25;2450)=2,193
Uma estatstica-Z de 1,96 tem uma significncia de 0,05, e 2,57 tem uma significncia de
0,01. Portanto, a probabilidade de que taxas superiores de reclamaes sejam devidas ao
acaso est entre 1:20 e 1:100.
Resultados baixos. O nmero real de reclamaes para julho e agosto 390. O nmero
esperado de reclamaes para este perodo deve ser um sexto, ou 16,6667 por cento das
2.450 reclamaes anuais. A estatstica-Z para essas propores :
ZSTAT((1,00000000*390/2450);0,16667;2450)=0,967
Este no um resultado muito significativo. As estatsticas-Z de 1,000 e menores so

muito comuns e podem ser normalmente ignoradas.
Captulo 3 P ARMETROS DE COMANDOS COMUNS

Os parmetros aqui descritos so comuns a vrios comandos no ACL. A maioria pode
ser especificada por meio de uma caixa de dilogo de comando ou na sintaxe do modo
de comando. Os comandos encontram-se descritos no Captulo 4: Comandos. Cada
descrio de comando inclui uma lista de parmetros.
All (Tudo)
Tudo usado para especificar at que ponto um comando executado em campos ou
registros.

Em um modo de comando, a opo All (Tudo) especifica que um comando deve ser
executado em todos os campos, expresses ou variveis de um tipo apropriado, geralmente numricas.
No exemplo a seguir, All faz com que o comando Total seja executado em todos os
campos ou expresses. Uma vez que o comando Total pode ser usado somente para
campos numricos, apenas campos deste tipo so totalizados.
TOTAL ALL
Caixa de dilogo de comando

O boto de opo Tudo est disponvel na guia [Mais]. Tudo selecionado como
padro. Na caixa de dilogo de comando Tudo especifica que todos os registros devem
ser processados.
91
92

Append (Anexar)
Manual de Referncia
Append (Anexar)
Anexar/Anexar a um arquivo existente um parmetro de escopo que adiciona a sada
produzida por um comando no final de um arquivo existente, em vez de substituir seu
contedo (sobrescrever). Esse parmetro vlido apenas quando o comando cria um
arquivo de sada.
Nota: Certifique-se de que a estrutura dos dois arquivos idntica, antes de usar esta
opo. O ACL anexa uma sada a um arquivo existente, qualquer que seja sua estrutura.

No exemplo a seguir, a sada do comando Extract (Extrair) anexada ao arquivo
existente Xtract.txt:
EXTRACT RECORD TO XTRACT.TXT APPEND

A caixa de seleo Anexar a um arquivo existente est disponvel na guia [Mais].
As (Como)
Como um modificador de campo usado para especificar um nome de substituio
para um campo existente ou expresso especfica.
Se Como for usado em um comando que cria outro arquivo, o nome especificado na
clusula Como ir se tornar o nome do campo, na nova definio de arquivo de entrada.
Uma vez que o nome uma cadeia de caracteres, qualquer expresso de caractere
vlida, desde que siga as convenes de nomeao de campos do ACL.
Como pode ser usado somente no modo de comando.
Captulo 3
Parmetros de comandos comuns

Ascending (Crescente)
93

AS "Nome_de_substituio"
As seguintes exibies de comando resultam em um campo chamado INVENTORY

(valor de estoque) (o ponto-e-vrgula provoca quebra de linha):
DISPLAY QtyOH*UnCst AS "INVENTORY;VALUE"
Ascending (Crescente)
Crescente um modificador de campo que especifica a ordem de classificao-padro
para campos-chave, incluindo campos calculados e expresses especficas. Ascendente
pode ser usado somente nos comandos Duplicates (Duplicidades), Gaps (Falhas), Index
(ndice), Sort (Ordenar) e Sequence (Seqncia).

A ordem ascendente est implcita. No h notao para Crescente.
No exemplo a seguir, o comando Sort (Ordenar) executado nos campos Classe de
produto (ProdCls), Local (Loc) e Quantidade disponvel (QtyOH). A sada enviada a
um arquivo de sada, Arquivo2. A ordem de classificao do arquivo de sada ascendente para os campos Classe de produto, Local e Quantidade disponvel.
SORT ON Loc ProdCls QtyOH TO "Arquivo2"

Clique em [Indexar em], [Ordenar em] ou [Sequncia em] e selecione os campos. O
boto de ordem de classificao exibido com o nome do campo na caixa de listagem
Campos selecionados. A ordem de classificao ascendente definida como padro.
Clique no boto para alterar a ordem de classificao.
94

Break (Quebra)
Manual de Referncia
Boto de ordem de classificao
Break (Quebra)
Quebra especifica campos de quebra em um comando e faz com que dados de relatrio
sejam quebrados sempre que o valor do campo especificado for alterado. Os subtotais
so gerados para cada valor no campo de quebra. Quebra tambm pode ser usada com
uma expresso que consiste em uma concatenao de mais de um campo.
Os campos de quebra devem ser campos de caracteres. Para usar Quebra em um campo
numrico, converta-o em campo de caractere usando a funo STRING ( ). Quebra
pode ser usada somente com os seguintes comandos: Classificar, Estratificar, Histograma e Perodo.
Nota: Para obter resultados significativos, seu arquivo deve estar previamente ordenado
ou indexado no campo especificado por Quebra.
Para obter mais informaes sobre o uso de colunas de quebras em exibies e
relatrios, consulte Modificar colunas na pgina 203 do Guia do Usurio do
ACL para Windows e Especificar colunas de quebra na pgina 204 do Guia do Usurio
do ACL para Windows. Para obter mais informaes sobre a insero de quebra de
pgina em um relatrio, aps os totais para o campo de quebra especificado, consulte
Page (Pgina) na pgina 107.

Consulte Key (Chave) na pgina 103.
Captulo 3

Descending (Decrescente)
95

As opes de Quebra esto disponveis na guia [Mais]. Para especificar um
campo-chave, digite um nome de campo na caixa de texto Quebra, ou clique em
[Quebra] e selecione um campo. Para especificar mais de um campo-chave, clique em
[Quebra] e, em seguida, [Expr] para chamar o Construtor de expresses. possvel
construir uma expresso que consista em mais de um campo, clicando nos nomes dos
campos e concatenando-os com um sinal de mais (+). Os nomes de campos devem estar
entre aspas. Para obter mais informaes, consulte Construir expresses na
Descending (Decrescente)
Decrescente um modificador de campo que especifica a ordem de classificao para
campos-chave, incluindo campos calculados e expresses especficas. A opo Decrescente pode ser usada somente nos comandos Duplicidades, Falhas, ndice, Ordenar e
Seqncia.
A ordem de classificao-padro ascendente. Para obter mais informaes, consulte
Ascending (Crescente) na pgina 93.

Descendente abreviado por um D.
Campos_selecionados D
No exemplo a seguir, o comando Sort (Ordenar) executado nos campos Classe de

produtos (ProdCls), Local (Loc) e Quantidade disponvel (QtyOH). A sada enviada
96

End of File (Fim de arquivo)
Manual de Referncia
para um arquivo de sada, Arquivo2. A ordem de classificao do arquivo de sada

crescente para Classe de produtos e Local, e decrescente para Quantidade disponvel.
SORT ON Loc ProdCls QtyOH D TO "Arquivo2"

Clique em [Indexar em], [Ordenar em] ou [Seqncia em] e selecione os campos. O
boto de ordem de classificao exibido com o nome do campo na caixa de listagem
Campos selecionados. A ordem de classificao definida como padro para ascendente. Clique no boto para alterar a ordem de classificao.
Boto de ordem de classificao

A opo Fim de arquivo faz com que o comando completo seja executado mais uma vez,
aps ter sido alcanado o final do arquivo. Fim de arquivo geralmente usado em
batches, quando o comando Grupo usado no processamento de um arquivo.

Fim de arquivo abreviado como EOF.
No exemplo a seguir, o batch ir preencher variveis para cada registro com a informao do campo e, em seguida, extrair as variveis quando for encontrado um registro
em branco. O batch repete o processo para cada endereo. Este processo funciona se o
padro de espaos em branco continuar e a ltima linha no batch tambm estiver em
branco. Entretanto, se a ltima linha no estiver em branco, o endereo final pode ficar
ausente. Neste caso, o uso de EOF far com que o comando Extract (Extrair) seja
Captulo 3

97
executado mais uma vez quando for alcanado o final do arquivo, evitando a perda do
ltimo endereo.
ADDRESS1=ADDRESSMAIN
COUNTER=0
GROUP IF ADDRESSMAIN=" "
EXTRACT ADDRESS1 ADDRESS2 ADDRESS3 ADDRESS4 TO OUT EOF
COUNTER=0
ELSE IF COUNTER=0
ADDRESS2=" "
ADDRESS3=" "
ADDRESS4=" "
COUNTER=1
ELSE IF COUNTER=1
COUNTER=2
ELSE IF COUNTER=2
COUNTER=3
ELSE IF COUNTER=3
COUNTER=4
END

A caixa de seleo EOF (Processamento do fim de arquivo) est disponvel na guia
[Mais].
98

File (Arquivo)
Manual de Referncia
File (Arquivo)
Arquivo especifica que a sada de um comando deve ser salva em um arquivo separado.
Para obter mais informaes, consulte To (Para) na pgina 111.

O parmetro File (Arquivo) geralmente omitido, uma vez que assumido como
padro.
TO "Nome_do_arquivo"
TO FILE "Nome_do_arquivo"
No exemplo a seguir, o comando Statistics (Estatsticas) produz um arquivo de sada

chamado Stattest.txt.
STATISTICS ON CstDte QtyOH SalePr TO "Stattest.TXT" NUMBER 5

A opo Arquivo est disponvel na guia [Sada]. Para salvar a sada em um arquivo,
selecione a opo Arquivo, selecione o tipo a partir da caixa suspensa Tipo de arquivo.
Digite um nome na caixa de texto Nome ou clique em [Nome] e digite um nome na
caixa de texto Nome do arquivo.
File Type (Tipo de arquivo)

Tipo de arquivo especifica o formato de sada de um arquivo. Dependendo do comando,
o formato de sada pode ser texto ou um arquivo de dados do ACL.

Consulte To (Para) na pgina 111. O tipo de arquivo especificado pela extenso do
arquivo.
Captulo 3

First (Primeiros)
99

Consulte File (Arquivo) na pgina 98.
First (Primeiros)
Primeiros um parmetro de escopo que faz com que um comando seja executado
sobre um nmero consecutivo de registros, comeando com o registro 1. O processamento encerrado aps o nmero especificado de registros ter sido alcanado.
Primeiros no depende da posio atual do registro.
Aps a execuo de um comando que contm um parmetro Primeiros, a posio de
registro estabelecida no registro que segue imediatamente o nmero de registros
especificado no comando. Se o fim do arquivo for alcanado durante a execuo, a
posio de registro ser redefinida para o registro 1.
Primeiros tambm pode ser usado em conjunto com Se ou Enquanto. Aps a execuo
de um comando no qual tanto Primeiros como Enquanto estiverem especificados, a
posio de registro determinada pelo parmetro Enquanto.

FIRST n
No exemplo a seguir, First (Primeiros) faz com que o comando Total seja encerrado aps
10 registros:
TOTAL ALL FIRST 10
A posio do registro ser sempre 11, aps o comando acima ter sido executado,
qualquer que seja a posio no incio do comando.

O boto de opo Primeiros est disponvel na guia [Mais].
100

Footer (Rodap)
Manual de Referncia
Footer (Rodap)
O boto Rodap usado para inserir um texto na parte inferior de cada pgina de um
relatrio. Isto ir ignorar qualquer valor definido por uma varivel de rodap.

FOOTER "Texto_rodap"
No exemplo a seguir, o comando Stratify (Estratificar) produz um arquivo que contm

um rodap.
STRATIFY ON UnCst ACCUMULATE QtyOH MINIMUM 10,00 MAXIMUM 100
INTERVALS 10 TO "UnitCost.TXT" HEADER "***INCIO DOS
DADOS***" FOOTER "***FINAL DOS DADOS***"

O boto Rodap est disponvel na guia [Sada]. Para incluir um rodap no relatrio,
digite o texto diretamente na caixa de texto do Rodap ou clique em [Rodap] e digite o
texto na caixa de dilogo Rodap.
Graph (Grfico)
A opo Grfico especifica que uma sada de um comando deve ser exibida em um
grfico. Grfico pode ser usado somente com os seguintes comandos: Benford, Classificar, Estratificar, Histograma e Perodo.
Captulo 3

Header (Cabealho)
101
Para obter mais informaes, consulte Sada para grfico na pgina 263 do

Consulte To (Para) na pgina 111.
No exemplo a seguir, a sada do comando Stratify (Estratificar) exibida em um grfico:
INTERVALS 10 TO GRAPH

A opo Grfico est disponvel na guia[Sada].
Header (Cabealho)
Cabealho usado para inserir um texto na parte superior de cada pgina de um
relatrio. Isto ignora qualquer valor definido por uma varivel de cabealho.

HEADER "texto_do_cabealho"
No exemplo a seguir, o comando Stratify (Estratificar) produz um arquivo que contm

um cabealho.
INTERVALS 10 TO "UnitCost.TXT" HEADER "***INCIO DOS
DADOS***" FOOTER "***FINAL DOS DADOS***"

O boto Cabealho est disponvel na guia [Sada]. Para incluir um cabealho no
relatrio, digite o texto diretamente na caixa de texto Cabealho ou clique em
[Cabealho] e digite o texto na caixa de dilogo Cabealho.
102

If (Se)
Manual de Referncia
If (Se)
Se um parmetro de escopo que faz com que um comando seja executado em registros
que satisfazem um determinado teste. Ele filtra todos os registros que falham no teste e
no depende da posio atual do registro.
Aps a execuo de um comando que contm uma clusula Se, a posio do registro
estabelecida no registro que segue imediatamente o nmero de registros especificado no
comando. Caso o fim do relatrio seja alcanado durante a execuo, a posio do
registro ser redefinida para o registro 1.
Se tambm pode ser usado em conjunto com Enquanto, Prximo ou Primeiros. Aps a
execuo de um comando no qual tanto Se como Enquanto estiverem especificados, a
posio do registro ser determinada pelo parmetro Enquanto.
Nota: Quando for aplicado um filtro global, a condio [Se] acrescentada ao, e no em
vez do, filtro.

IF Teste
No exemplo a seguir, os registros que tm um valor menor que 50, no campo

Quantidade Disponvel (QtyOH), so contados:
COUNT IF QtyOH < 50
Captulo 3

Key (Chave)
103

O boto [Se] est disponvel na guia [Principal]. Digite a condio diretamente na caixa
de texto Se, ou clique em [Se] para exibir o Construtor de expresses. Para obter mais
informaes, consulte Construtor de expresses na pgina 275 do Guia do Usurio do
ACL para Windows.
Key (Chave)
Chave especifica campos de quebra em um comando e faz com que dados de relatrio
sejam quebrados sempre que o valor do campo especificado for alterado. So gerados
subtotais para cada valor do campo de quebra. Chave tambm pode ser usado com uma
expresso que consiste em mais de um campo.
Campos-chave devem ser campos de caracteres. Para usar Quebra com um campo
numrico, converta-o em um campo de caractere usando a funo STRING( ).
Chave pode ser usado somente com os seguintes comandos: Classificar, Estratificar,
Histograma e Perodo.
Nota: Para obter resultados significativos, seu arquivo j deve ter sido ordenado ou
indexado no campo de Quebra especificado.

KEY Campos_do quebra
No exemplo a seguir, os resultados do comando Stratify (Estratificar) so exibidos por

classe de produto. So gerados totais separados para cada classe de produto no arquivo
fonte.
STRATIFY ON QtyOH ACCUMULATE SalePr Value MINIMUM 25 MAXIMUM
100 INTERVALS 10 KEY ProdCls TO SCREEN

Consulte Break (Quebra) na pgina 94.
104

Local
Manual de Referncia
Local
Este parmetro se aplica somente a arquivos processados usando o
Sistema ACL Cliente/Servidor. Local especifica que um arquivo de sada deve ser
gravado na unidade local ou do cliente. Quando Local assinalado, os comandos
gravam a sada na localizao do arquivo de projeto atual, a menos que seja fornecido
um caminho.

No exemplo a seguir, a sada do comando Classify (Classificar) salva na unidade local.
CLASSIFY ON Part_No TO "Parts Summary" LOCAL OPEN

Opes de sada esto disponveis na guia [Sada].
Name (Nome)
Nome usado para especificar o nome do arquivo de sada criado por um comando.


Opes de Sada esto disponveis na guia [Sada].
Captulo 3

Next (Prximo)
105
Next (Prximo)
Prximo um parmetro de escopo que faz com que um comando seja executado sobre
um nmero de registros, comeando no registro atual. O processamento encerrado
depois de ter sido atingido um nmero especificado de registros. Prximo depende da
posio atual do registro.
Aps a execuo de um comando que contm um parmetro Prximo, a posio de
registro definida no registro que segue imediatamente o nmero de registros especificado no comando. Caso o fim do arquivo tenha sido alcanado durante a execuo, a
posio de registro ser redefinida para o registro 1.
Nota: Uma vez que Prximo faz com que o processamento seja encerrado antecipadamente, ele no pode ser usado em um grupo, apesar de poder ser usado no comando de
Grupo mais externo de um conjunto de grupos aninhados.
Prximo tambm pode ser usado em conjunto com o Se ou Enquanto. A clusula
Prximo aplicada primeiro, independentemente do teste Se. Caso Enquanto e
Prximo estejam especificados no mesmo comando, a posio do registro ser determinada pela primeira das duas clusulas a finalizar o processamento.

NEXT n
No exemplo a seguir, Next (Prximo) faz com que o comando seja finalizado aps 10
registros:
TOTAL ALL NEXT 10
A posio do registro definida no primeiro registro depois de terem sido processados

10 registros. Por exemplo, se a posio do registro era 2 no incio do comando acima, o
registro ser posicionado em 12, aps o comando ter sido executado.
106

Nodups (Suprimir duplicidades)
Manual de Referncia

O boto de opo Prximo est disponvel na guia [Mais].
Nodups (Suprimir duplicidades)

Nodups (Suprimir duplicidades) um modificador de campo que faz com que valores
repetidos em um campo sejam exibidos como espaos em branco em um relatrio.
Nodups pode ser usado somente no modo de comando.

Nomes_de_campo NODUPS
Por exemplo, o seguinte comando de Report (Relatrio) suprime os valores repetidos

no campo Classe de Produto (ProdCls).
REPORT ON Loc ProdCls NODUPS ACCUMULATE QtyOH
Nozeros (Branco se for zero)

Nozeros (Branco se for zero) um modificador de campo que faz com que valores zero
em um campo sejam exibidos como espaos em branco em um relatrio.
Nozeros pode ser usado somente no modo de comando.

Nomes_de_campo NOZEROS
Por exemplo, o seguinte comando de Report (Relatrio) suprime os zeros no campo

Quantidade Disponvel (QtyOH):
REPORT ON Loc ACCUMULATE QtyOH NOZEROS
Captulo 3

Open (Abrir)
107
Open (Abrir)
Abrir um parmetro de escopo usado para abrir um arquivo que tenha sido criado por
um comando. Se um arquivo de entrada j estiver aberto, o ACL fechar o arquivo antes
de executar o comando. O arquivo recm-criado usado como arquivo de entrada. Este
parmetro vlido apenas quando o comando cria um arquivo de sada.
Para obter mais informaes sobre o uso do parmetro Abrir como um comando,
consulte Open (Abrir) na pgina 240.

"Novo_arquivo" OPEN
No exemplo a seguir, o comando Extract (Extrair) cria um arquivo Stockonhand

(estoque disponvel) e abre o arquivo automaticamente.
EXTRACT FIELDS Loc QtyOH TO "Stockonhand" OPEN

Consulte Use Output File (Usar arquivo de sada) na pgina 112.
Page (Pgina)
Page (Pgina) um modificador de campo que insere uma quebra de pgina aps os
totais, para o campo-chave especificado.
Page pode ser usado somente no modo de comando.

Campos_selecionados PAGE
Por exemplo, o comando a seguir produz um relatrio com dois nveis de subtotais: por
localizao e por classe de produto dentro da localizao. Aps cada linha de subtotal
por localizao, o relatrio continuar na parte superior de uma nova pgina.
REPORT ON Loc PAGE ProdCls ACCUMULATE QtyOH
Picture (Figura)
Figura um modificador de campo que especifica como formatar um campo de data ou
numrico. Figura pode ser usado somente no modo de comando. Para obter um equivalente de caixa de dilogo, consulte Campos numricos na pgina 157 do
108

Print (Imprimir)
Manual de Referncia
Guia do Usurio do ACL para Windows e Campos de data na pgina 158 do


Picture (Figura) abreviado como PIC.
PIC "Formato"
Por exemplo, o comando a seguir faz com que um arquivo de sada, Negfile, seja
produzido:
EXTRACT Value PIC "$9.999.999,99" IF Value < 0 TO "Negfile"
No Negfile, as quantidades no campo Value so exibidas com um smbolo de cifro

no incio, separadas por pontos e uma vrgula decimal.
Print (Imprimir)
Imprimir especifica que a sada de um comando seja impressa.

No exemplo a seguir, a sada do comando Stratify (Estratificar) impressa:
STRATIFY ON UnCst ACCUMULATE QtyOH MINIMUM 10 MAXIMUM 100
INTERVALS 10 TO PRINT

A opo Imprimir est disponvel na guia [Sada].
Record (Registro)
Registro refere-se a um registro como uma unidade, sem referncia aos seus campos.
Registro especifica que o registro inteiro (esteja ou no definido) deve ser colocado no
arquivo de sada em vez de ser colocado apenas em campos selecionados. Isto significa
Captulo 3

Screen (Tela)
109
que o arquivo de sada contm uma cpia exata do registro de entrada, incluindo toda e
qualquer definio de campo calculada.

No exemplo a seguir, o comando Extract (Extrair) produz um arquivo de sada
contendo todos os registros nos quais o Custo Unitrio (UnCst) maior que zero.
EXTRACT RECORD IF UnCst > 0 TO "EXTR_1"

A opo Registro est disponvel na guia [Principal].
Screen ( Tela)
A opo Tela especifica que a sada de um comando deve ser exibida no Log de comando
para reviso na tela.

No exemplo a seguir, a sada do comando Stratify (Estratificar) exibida no Log de
comando:
STRATIFY ON UnCst ACCUMULATE QtyOH MINIMUM 10 MAXIMUM 100
INTERVALS 10 TO SCREEN

A opo Tela est disponvel na guia [Sada].
110

Suppress (Suprimir)
Manual de Referncia
Suppress (Suprimir)
A opo Suprimir exclui quantidades fora de um intervalo de sada especificado.
Por exemplo, o comando Estratificar requer que os usurios especifiquem intervalos de
sada. Como padro, o comando analisa dois intervalos adicionais: o intervalo de
valores abaixo do mnimo especificado e o intervalo de valores acima do mximo
especificado. Suprimir ignora tal comportamento.
Suprimir tambm pode ser usado como modificador de campo, para suprimir a totalizao de campos numricos especficos, normalmente na sada para relatrio. Para
obter mais informaes, consulte Campos numricos na pgina 157 do

Apenas dados no intervalo especificado de 25 a 100 aparecem na sada do comando
Stratify (Estratificar), a seguir:
STRATIFY ON QtyOO MINIMUM 25 MAXIMUM 100 INTERVALS 10
SUPPRESS TO SCREEN

A partir da guia [Mais], assinale Suprimir outros para limitar a ao do comando ao
intervalo de valores especificado na guia [Principal].
Captulo 3

To (Para)
111
To (Para)
Para usado para especificar o formato de sada de um comando. Dependendo do
comando, a sada pode ser:
Exibida na tela
Impressa
Exibida em um grfico
Salva em um arquivo
Para obter mais informaes, consulte Graph (Grfico) na pgina 100, Print
(Imprimir) na pgina 108 e Screen (Tela) na pgina 109.

TO SCREEN
TO PRINT
TO GRAPH
TO "Nome_do arquivo"
No exemplo a seguir, a sada do comando Stratify (Estratificar) salva em um arquivo

chamado Rept1.txt:
INTERVALS 10 TO "Rept1.TXT"

Opes de sada esto disponveis na guia [Sada].
112

Use Output File (Usar arquivo de sada)
Manual de Referncia
Use Output File (Usar arquivo de sada)

Ao assinalar a caixa de seleo Usar arquivo de sada, o ACL abre o arquivo criado por
um comando. Caso um arquivo de entrada j esteja aberto, o ACL fecha o arquivo
aberto antes de abrir o arquivo recm-criado o qual, por sua vez, torna-se o arquivo de
entrada atual.

Consulte Open (Abrir) na pgina 107.

A caixa de seleo Usar arquivo de sada est disponvel na guia [Principal].
While (Enquanto)
Enquanto um parmetro de escopo que faz com que seja executado um comando
enquanto uma condio for verdadeira. O parmetro Enquanto faz com que o processamento de comandos seja encerrado assim que o teste especificado avalie a condio
como sendo falsa, ou quando for alcanado o fim do arquivo.
O parmetro Enquanto depende da posio atual do registro. Para iniciar o processamento, o registro atual deve ser avaliado como verdadeiro. Enquanto normalmente
usado com blocos de itens nos quais a condio avaliada como verdadeira.
Caso o fim do arquivo seja alcanado durante a execuo, a posio do registro ser
redefinida para registro 1.
Captulo 3

While (Enquanto)
113
O parmetro Enquanto tambm pode ser usado em conjunto com Se, Prximo ou
Primeiros.
Aps a execuo de um comando que contm Enquanto e Se ou Primeiros, a posio do
registro determinada pelo parmetro Enquanto.
Aps a execuo de um comando no qual tanto Enquanto como Prximo estejam
especificados, a posio do registro ser determinada pela primeira das duas clusulas
que finalizam o processamento.
Nota: Como o parmetro Enquanto pode antecipar o encerramento de um processamento,
no pode ser especificado em um grupo (apesar de poder ser usado no prprio comando
Grupo mais externo).

WHILE Teste
No exemplo a seguir, o comando Count (Contar) executado iniciando na posio atual

do registro, no campo Quantidade Disponvel, enquanto a Classe de Produto (Prod Cls)
for 07:
COUNT WHILE ProdCls = "07"
Assim que o comando falhar no teste While (Enquanto), o processamento ser interrompido e a posio do registro, definida no primeiro registro que falhar no teste.

O boto [Enquanto] est disponvel na guia [Mais]. Digite a condio diretamente na
caixa de texto Enquanto, ou clique em [Enquanto] para exibir o Construtor de
expresses. Para obter mais informaes, consulte Construir expresses na
114

Width (Largura)
Manual de Referncia
Width (Largura)
Largura um modificador de campo que especifica a largura da exibio de um campo
ou expresso, especificados em um relatrio. A largura de exibio-padro o comprimento definido do campo. A utilizao do parmetro Largura ir substituir o padro.
Width (Largura) pode ser usada somente no modo de comando.
Para obter mais informaes, consulte Alterar largura da coluna na pgina 204 do

FIELDS Nome_do campo WIDTH Valor
No exemplo a seguir, o comando Export (Exportar) produz um relatrio que contm os

campos Descrio de produto (ProdDesc) e Quantidade disponvel (QtyOH), com
larguras de 50 e 25, respectivamente.
EXPORT FIELDS ProdDesc WIDTH 50 QtyOH WIDTH 25 ASCII TO
"ProdQty"
Captulo 4
C OMANDOS
Esta seo contm uma descrio completa de cada comando do ACL. A descrio do
comando inclui uma explicao da ao do comando e seus parmetros. Os exemplos
so fornecidos com propsitos ilustrativos.
Accept (Aceitar)
O comando Aceitar permite criar batches interativos que provocam uma pausa para a
exibio de uma caixa de dilogo solicitando informaes do usurio.
Este comando s pode ser executado no modo de comando. No pode ser usado em um
comando Grupo. aconselhvel colocar todos os comandos Aceitar no incio de um
batch.
Use Aceitar para criar batches que solicitam informaes do usurio, tais como intervalos de amostragem, nomes de arquivos, nmeros de departamentos ou cabealhos e
rodaps de relatrio.
O ACL armazena as entradas do usurio em uma varivel de caractere. Quando a
entrada do usurio for um valor numrico necessrio para um comando ACL subseqente, o comando interpreta a entrada do usurio como um valor de caractere. Voc
pode precisar converter os dados do caractere em uma varivel para formato numrico
ou de data, antes de us-lo em outras operaes.
Para usar o contedo literal de uma varivel em um comando ou operao subseqente,
voc pode fazer referncia varivel pelo nome. Para que o ACL interprete o contedo
de uma varivel como sendo o nome de um campo ou arquivo, use o caractere de
porcentagem (%) antes e aps o nome da varivel. Isso converte o nome da varivel em
uma macro e instrui o ACL a adotar o contedo da varivel como referncia para um
campo ou arquivo nomeado.
Para obter mais informaes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows, Batches interativos na pgina 341 do Guia do Usurio do
ACL para Windows, e Macro de substituio na pgina 349 do Guia do Usurio do
ACL para Windows.
Para criar caixas de dilogo mais complexas, use o comando Dilogo. Para obter mais
informaes, consulte Dialog (Dilogo) na pgina 151.
115
116

Accept (Aceitar)
Manual de Referncia
Caixas de dilogo criadas com Aceitar

Quando o ACL encontra o comando Aceitar, ele suspende temporariamente o batch e
exibe uma caixa de dilogo instruindo o usurio a inserir informaes. Ao clicar em
[OK] na caixa de dilogo estar instruindo o ACL para aceitar as informaes e
continuar o processamento do batch. Ao clicar em [Cancelar] estar cancelando a
execuo do batch.
H dois modos de solicitar a entrada de um usurio. O usurio pode digitar o texto em
uma caixa de texto, ou fazer uma seleo a partir de uma lista suspensa. Listas suspensas
podem conter os nomes dos campos, variveis ou itens do Projeto, como batches, DAEs
(Definies de arquivo de entrada), ndices, exibies e relatrios. Para criar uma lista
suspensa, use o parmetro opcional Campos, com um ou mais identificadores de tipo
de campo. Para obter mais informaes, consulte Sintaxe do tipo de campo na
pgina 117.
Se uma DAE estiver aberta quando o comando Aceitar ou Dilogo for emitido, a lista
suspensa conter somente itens especificados pela DAE aberta no momento. Se
nenhuma DAE estiver aberta quando o comando for emitido, as listas suspensas estaro
em branco.
Parmetros
O comando Accept (Aceitar) tem os seguintes parmetros: Fields (Campos), To (Para).
Fields (Campos)
Permite o uso de listas suspensas ao invs de caixas de texto para a entrada do usurio.
Listas suspensas podem conter um ou mais tipos de campo.
To (Para)
Atribui a resposta do usurio a uma varivel de caractere nomeada.

Cada comando Accept (Aceitar) separado gera uma caixa de dilogo separada. Para
criar uma caixa de dilogo com vrias solicitaes (prompts), use um nico comando
Aceitar com vrias cadeias de solicitaes e nomes de variveis separados por vrgulas.
ACCEPT "cadeia_de_solicitaes" <FIELDS "tipos_de_campo"> TO
nome_da_varivel <; .... >
Captulo 4
Comandos
Accept (Aceitar)
117
cadeia_de_solicitaes especifica a mensagem que solicita informaes do
usurio durante a execuo do batch. A cadeia de solicitaes deve estar entre aspas e
deve ser curta.
nome_da_varivel especifica o nome da varivel de caractere que armazena a
resposta do usurio e no exige aspas. Se uma varivel nomeada j contiver um valor, a

caixa de dilogo exibe o mesmo.
tipos_de_campo especifica os tipos de campo a serem exibidos na lista suspensa. Os
tipos de campo devem estar entre aspas. Nomes de campo e nomes de varivel podem
aparecer na mesma lista suspensa. Por exemplo, FIELDS "CNLD" gera uma lista
suspensa contendo os nomes de todos os campos, e FIELDS "CNLDcnld" gera uma
lista suspensa contendo os nomes de todos os campos e de todas as variveis.
Nota: No misture itens xixrxbxfxw com itens CcNnLlDd. Voc no deve ter tipos de
item de Projeto na mesma lista com nomes de campo ou nomes de variveis. Isso pode
resultar em escolhas inadequadas do usurio, que causam erros de processamento.
Sintaxe do tipo de campo

Tipo de
Campo
Gera uma lista suspensa contendo
Campos de caractere
Variveis de caractere
Campos numricos
Variveis numricas
Campos lgicos (filtros)
Variveis lgicas
Campos de data
Variveis de data
xb
Batches
xf
Arquivos de entrada
xi
ndices
xr
Exibies e relatrios
xw
reas de trabalho
118

Accept (Aceitar)
Manual de Referncia
Caixas de dilogo de solicitao nica

Para criar uma caixa de dilogo de solicitao nica, use somente uma cadeia de solicitao para cada instncia do comando Accept (Aceitar). Use a sintaxe a seguir para criar
um batch denominado Random_sample, que gera solicitaes separadas para um nome
de arquivo, uma lista suspensa dos campos que podem ser amostrados, um intervalo de
amostragem e um valor inicial aleatrio. Observe que o caractere % usado para fazer
referncia ao nome da varivel, ao representar o nome de um arquivo ou o nome de um
campo.
O smbolo de retorno de carro () marca o final de cada linha em um texto de linhas
mltiplas.
ACCEPT "Entre com o nome do arquivo para analisar" TO
FILENAME
OPEN %FILENAME%
ACCEPT "Selecione o campo para ser amostrado" FIELDS "N" to
SAMFIELD
ACCEPT "Informe o intervalo de amostragem" TO SAMINT
ACCEPT "Informe um valor inicial aleatrio" to RANSTART
SAMPLE ON %SAMFIELD% INTERVAL SAMINT FIXED RANSTART RECORD
TO INVSAMP
Quando voc executa o batch, a primeira caixa de dilogo exibida solicitando o nome
do arquivo.
A segunda caixa de dilogo solicita o nome do campo a ser amostrado. A sintaxe para
esta solicitao, mostrada na terceira linha de comando acima, usa a palavra-chave
FIELDS 'N'. Como resultado, essa caixa de dilogo contm uma lista suspensa dos
campos numricos disponveis.
A terceira caixa de dilogo solicita o valor do intervalo.
Captulo 4
Comandos
Accept (Aceitar)
119
E a quarta solicita o valor inicial aleatrio.
O ACL exibe o resultado do batch no Log de comando. Observe que o ACL avalia a
macro %FILENAME% na linha dois do batch e abre o arquivo Inventory.
O Log de comando mostra que os registros foram extrados para um arquivo chamado
Inventory_sample. Para exibir os registros amostrados, selecione Inventory_sample na
caixa de dilogo Selecionar Arquivo de Entrada.
120

Activate (Ativar)
Manual de Referncia
Caixa de dilogo com mltiplas solicitaes

Para criar uma caixa de dilogo com mltiplas solicitaes, insira diversos conjuntos de
parmetros de comandos separados por vrgulas para uma instncia do comando
Accept (Aceitar), todos na mesma linha, como segue:
ACCEPT 'Selecione o campo para amostra' FIELDS 'N' TO
SAMFIELD, 'Informe o intervalo de amostragem' TO SAMINT,
'Informe o valor de incio aleatrio' TO RANSTART
O comando Accept acima produz uma caixa de dilogo com uma lista suspensa de
nomes de campos e duas caixas de texto.
Activate (Ativar)
Ativar usado somente para reas de trabalho. O comando Ativar usado quando voc
tem um conjunto de campos armazenados em uma rea de Trabalho que so usados
com vrios arquivos de entrada.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Por exemplo, Ativar permite usar campos calculados durante a utilizao de um arquivo
dBASE. Alm disso, ao trabalhar com arquivos de vrios tipos de registros, voc pode
armazenar a definio referente a cada tipo de registro em uma rea de trabalho
separada. Se voc pretende trabalhar com poucos tipos de cada vez, pode ativar as reas
de trabalho apropriadas.
O comando Ativar traz todos os campos da rea de Trabalho especificada para o
ambiente atual, somente para a sesso em curso. Para tornar as definies ativadas uma
parte permanente da definio de arquivo de entrada, use o comando Salvar antes que
um novo arquivo seja aberto, ou antes que a sesso seja terminada.
O comando Ativar adiciona temporariamente um conjunto de definies de campo,
contido em uma rea de trabalho, ao conjunto de campos existente para o arquivo de
Captulo 4
Comandos
Activate (Ativar)
121
entrada atual. Para obter mais informaes, consulte Ativar reas de trabalho na
Nota: Quando voc altera campos da rea de trabalho ativa, os campos so salvos
automaticamente com o arquivo de entrada.
Para usar o comando Ativar importante conhecer como funcionam as reas de
trabalho. Para obter mais informaes, consulte Save (Salvar) na pgina 290 e reas
de trabalho na pgina 355 do Guia do Usurio do ACL para Windows.
Parmetros
O comando Activate (Ativar) tem os seguintes parmetros: OK, Workspace (rea de
trabalho).
OK
Indica que um campo do arquivo de entrada com um nome idntico a um campo da
rea de trabalho ativa ser substitudo (sobrescrito) sem confirmao. No possvel
substituir um campo referenciado por um campo calculado.
Padro: Confirmar antes de substituir um campo.
Workspace (rea de trabalho)

Indica que uma rea de trabalho deve ser ativada.

ACTIVATE <WORKSPACE> nome-da-rea-de-trabalho <OK>
nome-da-rea-de-trabalho especifica o nome da rea de trabalho que voc quer
ativar para o Projeto atual.
Exemplo
Este exemplo usa o comando Activate (Ativar) para ativar uma rea de trabalho,
Inventory-margin (margem de estoque), contendo campos calculados que calculam as
margens unitrias e margens em percentuais unitrios para itens de um arquivo de
estoque.
Para exibir o contedo do arquivo antes de ativar a rea de trabalho, digite DISPLAY na
caixa de texto do Log de comando.
O ACL exibe o contedo do arquivo na janela Log de comando.
122

Activate (Ativar)
Manual de Referncia
Para ativar a rea de trabalho usando o comando Activate, digite o seguinte na caixa de
texto do Log de comando:
ACTIVATE WORKSPACE INVENTORY_MARGIN
Reemita o comando Display (Exibir) para revelar o contedo do arquivo, aps ativar
Inventory_margin, e v at a parte inferior da janela. Os dois campos ativados, Loc05 e
City (Cidade), aparecem como os dois ltimos campos da exibio.
Captulo 4
Comandos
Age (Perodo)
123
Age (Perodo)
Use o comando Perodo para produzir resumos de dados por perodos. Os exemplos
incluem avaliao de tendncias de vendas, observao de volumes de transaes e a
classificao de faturas pelo nmero de dias a vencer a partir de uma data em particular.
A menos que voc especifique uma data limite, o perodo baseado na data atual do
sistema.
Voc pode especificar pontos de partida tais como 0, 90, 120 e assim por diante, para
cada perodo de vencimento, ou pode aceitar as definies padro de 0, 30, 60, 90, 120,
e 10.000 dias.
O nmero de registros em cada perodo exibido no Log de comando em uma coluna
gerada pelo ACL, intitulada COUNT, visualizada no Exemplo na pgina 125. Voc
pode tambm acumular a totalizao dos campos numricos para cada perodo.
Parmetros
Alm dos parmetros descritos abaixo, o comando Age (Perodo) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break (Quebra), File
(Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph
(Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo),
Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), While (Enquanto). Para
obter a descrio desses parmetros, consulte o Captulo 3: Definir arquivos e
campos.
Accumulate Fields (Acumular campos)

Permite que voc selecione campos numricos a serem totalizados. Selecione os campos
a partir da exibio da lista Acumular campos, ou clique em [Acumular campos] para
exibir a caixa de dilogo Campos selecionados. Voc pode ento selecionar os campos a
partir da exibio da lista Campos disponveis.
Age On (Perodo em)

Permite que voc selecione o campo de data ou expresso a ser classificado por perodo.
Selecione o campo a partir da lista suspensa Perodo em, ou clique em [Perodo em]
para exibir a caixa de dilogo Campos selecionados, na qual voc pode selecionar um
campo no modo de exibio de lista Campos disponveis.
Aging Periods (Perodos)

Permite que voc especifique o incio de cada perodo. A ltima entrada representa o
fim do perodo final. Informe um valor por linha, na caixa de texto Perodos. Use 10.000
dias para isolar itens com datas invlidas.
124

Age (Perodo)
Manual de Referncia
As definies padro so 0, 30, 60, 90, 120, 10.000 dias. Esses padres so definidos na
caixa de dilogo Editar preferncias do ACL. Para informaes sobre alteraes desses
padres, consulte Perodos na pgina 324 do Guia do Usurio do ACL para Windows.
Cutoff Date (Data limite)

Permite que voc especifique a data com a qual as datas no campo [Perodo em] so
comparadas. Voc pode usar o calendrio interno na caixa de dilogo Perodo para
selecionar uma data.
No modo de comando voc precisa especificar a data de limite em formatos de caractere
AAMMDD ou AAAAMMDD, independente do formato do campo de data.
A data limite padro a data atual do sistema.
Caixa de dilogo Perodo

Clique em
(Perodo) ou selecione Analisar, a partir da barra de menus, e escolha
Perodo para exibir a caixa de dilogo Perodo.
Sada do comando
A sada do Log de comando para esse comando tem colunas para intervalos de vencimento, o nmero de registros em cada intervalo e o percentual do total de registros
representado para cada um dos intervalos. Se um ou mais campos foram acumulados,
colunas adicionais so exibidas: outra coluna de percentual e os totais acumulados dos
campos para cada classificao.
Captulo 4
Comandos
Age (Perodo)
125
Cada coluna de percentual aponta para a coluna que ela representa. A coluna de
percentual localizada direita aponta para a coluna de campo acumulado mais prxima
e exibe o percentual do valor total representado pelo valor desse intervalo. Os percentuais no so fornecidos para colunas adicionais de campos acumulados.
Datas anteriores data limite caem em um dos perodos de vencimento especificados. O
ACL cria outro perodo <0, para datas mais recentes que a data limite.
Exemplo
Analise os registros em um arquivo de contas a receber, para determinar o nmero e
valor dos registros entre 30 a 59 dias aps a data do vencimento. Disponha os registros
de acordo com um campo data de vencimento e acumule em um campo de valores
devidos, usando 13 de novembro de 2000 como data limite. Use as definies padro
para os perodos de vencimento.
1. Com o arquivo Ar aberto, clique em [Perodo] na barra de botes, ou selecione
Analisar na barra de menus e escolha Perodo para exibir a caixa de dilogo
Perodo.
2. Selecione o campo Due (Vencimento) a partir da lista suspensa Perodo em.
Voc tambm pode clicar em [Perodo em] para exibir a caixa de dilogo Campos
selecionados, que fornece mais informaes sobre os campos que voc est selecionando.
126

Age (Perodo)
Clique para selecionar o

campo e, a seguir, use a ou
seta
Manual de Referncia
Clique duas vezes

no campo
ou
Clique para exibir o

Construtor de expresses
H trs formas para selecionar campos usando a caixa de dilogo Campos selecionados:
Clique no nome do campo a selecionar e use a

entre as caixas de lista.
(seta) para mov-lo
Clique duas vezes no nome do campo a selecionar e mova-o da exibio da lista

Campos disponveis para a caixa de listagem Campos selecionados.
Clique em [Expr] para exibir o Construtor de expresses, de modo que possa
construir uma expresso de data.
Selecione o campo Due na lista e clique em [OK] para retornar caixa de dilogo
Perodo.
3. Especifique a data limite. Clique na seta na lista suspensa Data limite para exibir o
calendrio a partir do qual voc pode selecionar sua data limite. Ento, clique nas
setas, no ms ou no ano para selecionar outra data.
Captulo 4
Comandos
Age (Perodo)
Clique para exibir calendrio
Clique nas setas ou no

ms para alterar o ms
127
Acumula esse campo
Clique em ano para alterar o ano
4. Selecione os campos a serem totalizados. Selecione os nomes dos campos na caixa de

listagem Acumular campos ou clique em [Acumular campos] para exibir a caixa
de dilogo Campos selecionados.
Aps ter selecionado os campos, clique em [OK] para retornar caixa de dilogo
Perodo.
5. Clique em [OK] novamente, para fechar a caixa de dilogo e executar o comando
Perodo. Os resultados aparecero no Log de comando.
128

Assign (Atribuir)
Manual de Referncia
A coluna COUNT exibe o nmero de registros em cada categoria.

O Log de comando mostra que o valor das transaes vencidas entre 30 e 59 dias
93.890,50. Esse valor representa 4,27% do nmero total de registros e 2,00% do total
de contas a receber.
Itens vencidos acima de 10.000 dias provavelmente constituem campos de data
invlidos.

AGE <ON> nome_do_campo_de_data <CUTOFF yymmdd>
<ACCUMULATE nome do campo numrico>
<INTERVAL>
Ponto inicial do intervalo
<; ....>
Ponto final do intervalo
<KEY campo de quebra> <+....>
<IF teste> <WHILE teste> <FIRST|NEXT intervalo>
<TO nome-do-arquivo-a-ser-criado|SCREEN|GRAPH|PRINT>
<HEADER cabealho>
<FOOTER rodap>
<SUPPRESS>
<APPEND>
Assign (Atribuir)
Voc pode usar o comando Atribuir para armazenar um valor como uma varivel.
Tambm pode anexar uma condio ao comando Atribuir.
O comando Atribuir geralmente usado em um batch no qual se deseja alterar o valor
de uma varivel. Se o comando Atribuir for emitido sem uma condio, a atribuio
ocorre automaticamente.
O comando Atribuir pode ser usado como um comando separado ou num grupo. Um
comando Atribuir em um grupo executa a atribuio, toda vez em que o comando
encontrado, se o teste resultar em verdadeiro para aquele registro ao menos uma vez por
registro.
Se voc atribuir um valor a um nome de varivel existente e a varivel estiver sendo
usada em um campo calculado ou a atribuio for feita em um grupo, o valor atribudo
ajustado para as especificaes previamente definidas para aquela varivel; o comprimento preenchido ou truncado, e os decimais so ajustados, se necessrio.
Se voc atribuir um valor para o nome de uma varivel existente e a varivel no estiver
sendo usada em um campo calculado ou for atribuda fora de um grupo, o valor anterior
e suas especificaes so substitudos.
Captulo 4
Comandos
Assign (Atribuir)
129
O ACL reconhece diversas variveis especiais, como Header e Footer. Se forem

atribudos valores de caractere a qualquer uma dessas duas variveis, sero automaticamente usados como cabealhos ou rodaps de pgina, se no for especificado um
cabealho ou rodap de outra forma. Esse recurso de formatao automtica de pgina
permanece em vigor at que as variveis sejam excludas ou at o fim da sesso atual.
Esteja ciente da existncia dessas variveis durante o uso do comando Atribuir.
Nota: Voc tambm pode criar novas variveis e editar as j existentes usando o
Construtor de expresses.
Para obter mais informaes, consulte Variveis criadas pelo usurio na pgina 347 do
Parmetros
O comando Assign (Atribuir) tem o seguinte parmetro: If (Se). Para obter uma
descrio, consulte Captulo 3: Parmetros de comandos comuns.

<ASSIGN> nome-da-varivel = expresso <IF teste>
ASSIGN opcional na sintaxe de comando, porque o sinal = o operador de
atribuio no ACL.
nome-da-varivel = expresso interpretada automaticamente como uma
atribuio.
nome-da-varivel especifica o nome da varivel a ser criada. Todas as convenes
de nomenclatura de campo so aplicveis. Consulte Funes na pgina 286 do

Guia do Usurio do ACL para Windows para obter detalhes.
expresso especifica o valor a ser atribudo para a varivel. Todas as convenes de
expresses do ACL so aplicveis.
Exemplo 1
Tome o valor da classe do produto para ao registro atual e o atribua a uma varivel
denominada MPRODCLS.
Digite MPRODCLS = PRODCLS na caixa de texto do Log de comando.
Como MPRODCLS uma varivel, seu valor no ir se alterar a menos que seja explicitamente alterado por outro comando Atribuir.
130

Benford
Manual de Referncia
Exemplo 2
Use o seguinte comando em um batch para atribuir o valor l varivel SAMPLE_QTY,
sempre que MCOUNT for menor que 10:
SAMPLE_QTY = 1 IF MCOUNT < 10
Se MCOUNT for maior ou igual a 10, nenhuma ao tomada pelo ACL. Isso significa
que o valor de SAMPLE_QTY permanece inalterado. Se a varivel no existia anteriormente, no ser criada.
Benford
O comando Benford permite que voc gere anlise digital usando a frmula de Benford.
Esse comando conta o nmero de vezes que cada dgito ou combinao de dgitos
esquerda ocorre, em um conjunto de dados, e compara o resultado real ao resultado
esperado. O resultado esperado calculado usando a frmula de Benford. O comando
de sada pode ser enviado para um grfico.
Para ajud-lo a avaliar o significado dos desvios entre as contagens real e esperada, o
comando de sada inclui a estatstica-Z para cada uma. Voc pode tambm usar a opo
Limites para ajud-lo a identificar freqncias de dgitos que estejam fora das expectativas de forma significativa. Quando mais de uma coluna de resultado fica fora dos
limites, os dados representados por essas colunas podem ser anmalos.
Para obter mais informaes sobre anlise digital, consulte Digital Analysis Using
Benfords Law: Tests & Statistics for Auditors, de Mark J. Nigrini, Ph.D., publicado pela
Global Audit Publications.
Nota: As ferramentas de anlise digital como o comando Benford permitem que auditores
e outros analistas de dados se concentrem em possveis anomalias, em conjuntos de dados
volumosos. Elas no provam a existncia de um erro ou fraude, mas identificam itens que
merecem estudo posterior, com base em fundamentos estatsticos. A anlise digital complementa as ferramentas e tcnicas analticas existentes, e no deve ser usada isoladamente
delas.
Parmetros
Alm dos parmetros descritos abaixo, o comando Benford tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break (Quebra), File
(Grfico), Header (Cabealho), If (Se), Name (Nome), Next (Prximo), Print
(Imprimir), Screen (Tela), Use Output File (Usar arquivo de sada), While (Enquanto).
Captulo 4
Comandos
Benford
131
Para obter a descrio desses parmetros, consulte o Captulo 3: Parmetros de

comandos comuns.
Benford On (Benford Em)

Permite a seleo de um campo numrico na lista suspensa Benford Em. Ou clique em
[Benford Em] para exibir a caixa de dilogo Campos selecionados. Voc pode ento
selecionar um campo da caixa de listagem Campos disponveis, ou usar uma expresso
para criar os valores a serem analisados.
Include Upper and Lower Bounds (Incluir limite superior e inferior)

Permite incluir limites superior e inferior em sua sada.
Number of Leading Digits (Quantidade de dgitos anteriores)

Permite especificar o nmero dos Dgitos iniciais ( esquerda) a serem analisados.
Digite um valor entre 1 a 6.
Por exemplo, se um campo numrico chamado Valor contm o valor $6. 234,56, o valor
analisado :
623 se Dgitos anteriores for = 3
Se um campo numrico chamado Valor contm o valor $3,55, o valor analisado :
Entrada
Esse comando analisa campos numricos. Voc pode especificar at seis Dgitos
anteriores (Iniciais) a serem analisados. Quando h mais de trs Dgitos iniciais, a
anlise Benford precisa ser enviada para um arquivo. A anlise de cinco ou mais Dgitos
iniciais leva tempo e o ACL avisa no Log de comando que est executando. Use a tecla
ESC para interromper o comando a qualquer tempo, antes dos resultados aparecerem no
Log de comando.
Uma anlise Benford eficaz requer amostras de tamanho grande. O ACL previne
quando um tamanho de amostra pode ser muito pequeno para o nmero de dgitos
especificado.
Dados anmalos aparecem melhor quando voc analisa valores positivos e negativos
separadamente. Voc pode usar um filtro para separar os dois valores, antes de comear
a anlise. Dgitos ou combinaes de dgitos com valores iguais a zero so automaticamente excludos.
132

Benford
Manual de Referncia
O comando Benford ignora registros com valores iguais a zero, mas relata o nmero de
registros de valor zero ignorados. Tambm ignora zeros esquerda, formatao
numrica como decimais e sinais de cifro e outros dgitos no numricos. Se o nmero
resultante de dgitos for menor que o especificado, o ACL adiciona zeros direita do
resultado.
Sada
A sada padro um arquivo de dados do ACL, em formato de tabela. Voc tambm
pode enviar a sada para um grfico de linhas ou para um grfico de barras em 2-D.
Sada em tabela
A tabela contm quatro colunas: Dgitos anteriores, Contagem real, Contagem esperada
e Zstat razo. Se selecionar a opo limites, a tabela conter duas colunas adicionais,
Limite superior e inferior.
Nenhuma sada produzida para registros que deixam de atender os critrios de teste ou
para registros que contm somente zeros.
A coluna de Dgitos anteriores mostra os dgitos iniciais testados. Por exemplo, se voc
especificar um dgito inicial, Dgitos anteriores exibe os nmeros de 1 a 9. Se voc
especificar dois dgitos iniciais, Dgitos anteriores exibe os nmeros de 10 a 99.
A coluna Contagem real mostra a contagem de cada dgito inicial ou a combinao de
dgitos iniciais encontrada na populao.
A coluna Contagem esperada mostra o valor calculado de acordo com a frmula de
Benford.
A coluna Zstat razo exibe a estatstica-Z para cada combinao de dgitos. Consulte
ZSTAT( ) na pgina 88.
Sada em grfico
O grfico mostra a contagem real, o valor Benford esperado e os limites superior e
inferior, se a caixa Incluir Limite superior e inferior na guia [Principal] estiver
assinalada. A anlise de um nico dgito inicial produz 9 pontos de dados no eixo x, a de
dois dgitos iniciais produz 90 pontos, a de trs dgitos iniciais produz 900 pontos e
assim por diante.
Voc pode tambm clicar duas vezes em <<<Dados de grfico>>> no Log de
comando para exibir o grfico.
Captulo 4
Comandos
Benford
133
Caixa de dilogo Benford

Clique em
(Benford) ou selecione Analisar na barra de menus e escolha Benford
para exibir a caixa de dilogo Benford.

BENFORD ON campo numrico <LEADING n> <IF condio> BOUNDS
TO <Arquivo ACL|SCREEN|GRAPH|PRINT> <HEADER cabealho>
<FOOTER rodap> <WHILE condio> <FIRST> <NEXT> <APPEND>
<ABRIR>
campo numrico especifica o campo numrico a ser analisado.
LEADING n especifica o nmero de dgitos esquerda (iniciais) a serem analisados.
Atribua a n um valor positivo de 1 a 6. O padro 1.
BOUNDS inclui os limites superior e inferior na sada.
Exemplo
BENFORD ON Amount LEADING 2 BOUNDS TO SCREEN
Os resultados aparecem no Log de comando e so exibidos em grfico.
134

Calculate (Calcular)
Manual de Referncia
O comando Calcular calcula e exibe o valor de uma expresso.
Este comando s pode ser executado no modo de comando. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
O resultado de Calcular pode ser um valor de caractere, lgico, numrico ou de data.
Para efetuar vrios clculos ao mesmo tempo, separe as expresses a serem avaliadas
por vrgulas.
Captulo 4
Comandos
135
O comando Calcular oferece a funcionalidade de uma calculadora combinada com o

acesso a funes, variveis e dados do ACL no registro atual. Em um clculo numrico,
o resultado tem tantas casas decimais quantas tiver o componente da expresso com o
maior nmero com casas decimais. Por exemplo, o resultado de 365,0000/12,0 tem
quatro casas decimais. Consulte Aritmtica de ponto fixo na pgina 284 do
Sempre que utilizar o comando Calcular sem fornecer um nome para o resultado, por
meio do modificador Como, o ACL nomeia o resultado com o nome da expresso.
Consulte Modificadores de campo na pgina 261 do Guia do Usurio do
ACL para Windows para obter mais informaes sobre o uso de As (Como).
Pr-requisitos
Se a expresso contm um valor de campo de um arquivo de entrada, o arquivo de
entrada apropriado deve ser aberto. Use os comandos Localizar, Encontrar ou Buscar
para mover o registro a ser analisado por Calcular. Para mais informaes, consulte
Find (Localizar) na pgina 195, Seek (Encontrar) na pgina 297, e Search
(Pesquisar) na pgina 291.
Parmetros
O comando Calculate (Calcular) tem o seguinte parmetro: As (Como). Para obter uma
descrio, consulte o Captulo 3: Parmetros de comandos comuns.

CALCULATE expresso <AS "nome da expresso">
<; ....>
expresso Voc pode especificar qualquer expresso vlida do ACL sujeita aos
pr-requisitos acima. Consulte Construtor de expresses na pgina 275 do

Guia do Usurio do ACL para Windows para obter detalhes sobre a ordem de precedncia de avaliao de expresses do ACL e uma lista dos operadores vlidos.
nome da expresso permite especificar um nome para o resultado do comando
Calcular. O nome deve vir, obrigatoriamente, entre aspas ou ser uma expresso vlida de
caracteres. Padro: A cadeia de expresso.
Exemplo 1
Para multiplicar 4,7 por 18,5 rapidamente usando o ACL, digite CALC 4,7*18,5 na
caixa de texto do Log de comando.
136

Classify (Classificar)
Manual de Referncia
Clique em
(Aceitar Entrada) ou pressione ENTER para calcular o resultado. Escolha
ltimo resultado na lista suspensa do Log de comando para exibir o resultado.
Nota: O ACL arredonda o resultado de 86,95 para 87,0.
Consulte Aritmtica de ponto fixo na pgina 284 do Guia do Usurio do
ACL para Windows para obter mais detalhes.
Exemplo 2
Calcule a margem bruta e o percentual da margem bruta para o registro atual. Usando
campos previamente definidos para o preo de venda e custo unitrio, calcule a margem
de lucro bruta e o percentual da margem bruta por unidade, para o registro atual.
Nomeie os resultados apropriadamente e, a seguir, digite CALCULATE SALEPR-UNCST
AS 'MARGIN' na caixa de texto do Log de comando.
Selecione ltimo resultado na lista suspensa do Log de comandos, para exibir o
resultado.
Use o comando Classificar para contar o nmero de registros relativos a cada valor
nico de um campo de caractere e para acumular totais de campos numricos especificados para cada um desses valores nicos.
O nmero de registros para cada valor exibido em um campo gerado pelo ACL,
denominado COUNT. O limite no nmero de totais depende da RAM disponvel em
seu computador, mas normalmente de 50.000 ou mais. H cerca de 20.000 totais por
megabyte, conforme configurado pela preferncia RAM Mx(MB).
Captulo 4
Comandos
137
O comando Classificar trabalha com dados no ordenados e particularmente til para

uma rpida varredura e sumarizao dos dados. Voc pode usar o comando Classificar
em uma grande variedade de circunstncias. Por exemplo, Classificar pode gerar
rapidamente um saldo experimental, a partir de transaes no-ordenadas de um livro
razo. O comando Classificar tambm pode substituir a necessidade de executar as
operaes Ordenar e Sumarizar separadamente.
Voc pode dizer ao ACL para colocar os resultados do comando Classificar em um novo
arquivo de entrada para posterior anlise e gerao de relatrio com o ACL, ou
direcionar os resultados para a impressora ou tela.
Este comando pode ser de execuo automtica. Para obter mais informaes sobre a
preferncia Execuo Automtica de Comandos, consulte Opes de comando na
Parmetros
Alm dos parmetros descritos abaixo, o comando Classify (Classificar) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Break
(Quebra), File (Arquivo), File Type (Tipo de arquivo), First (Primeiros), Footer
(Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome),
Next (Prximo), Print (Imprimir), Screen (Tela), Use Output File (Usar arquivo de
sada), While (Enquanto). Para uma descrio desses parmetros, consulte o
Captulo 3: Parmetros de comandos comuns.

Especifica os campos ou expresses numricas a serem totalizados pelo ACL para cada
classe. Selecione os campos na caixa de listagem ou clique em [Acumular campos] para
exibir a caixa de dilogo Campos selecionados, na qual voc pode selecionar campos e
criar expresses. Para obter mais informaes sobre a caixa de dilogo Campos selecionados, consulte Caixas de dilogo selecionar/editar na pgina 40 do Guia do Usurio
do ACL para Windows.
Classify On (Classificar em)

Especifica a expresso ou campo de caractere do arquivo de entrada a ser classificado(a). Selecione o campo na lista suspensa, ou clique em [Classificar em] para exibir
a caixa de dilogo Campos selecionados, na qual voc pode selecionar os campos e
construir expresses.
Sada do comando
A sada no Log de comando para esse comando tem colunas para o nome da classificao, o nmero de registros em cada classificao e o percentual do total de registros
que cada classificao representa. Se um ou mais campos forem acumulados, sero
138

Manual de Referncia
exibidas colunas adicionais: outra coluna de percentual e o total de campos acumulados

para cada classificao.
Cada coluna de percentual aponta para a coluna que ela representa. A coluna de
percentual direita aponta para a coluna de campo acumulado mais prxima, e mostra
o percentual do valor total que o valor desse intervalo de classificao representa. Os
percentuais no so fornecidos para colunas adicionais de campo acumulado.
Caixa de dilogo Classificar

Clique em
(Classificar) ou selecione Analisar na barra de menus e escolha Classificar para exibir a caixa de dilogo Classificar.
Exemplo
Para classificar um arquivo de transao de vendas de acordo com o nmero do
produto, use o comando Classificar. Voc pode fazer isso a fim de determinar quais
produtos so lderes de venda e quais esto potencialmente obsoletos.
Nota: O comando Classificar no exige que os dados estejam ordenados.
Acumule campos referentes quantidade disponvel e ao valor da transao e envie a
sada para um arquivo denominado Prodsale.
Captulo 4
Comandos
A visualizao padro do arquivo Prodsale aparece.

CLASSIFY <ON> nome_do_campo_de_caractere
<TO nome-do-arquivo-a-ser-criado|SCREEN|GRAPH|PRINT>
<ACCUMULATE lista de campos numricos>
<INTERVALS=n>
<SUPPRESS>
<HEADER cabealho>
<FOOTER rodap>
<KEY expresso de campo de quebra>
139
140

Close (Fechar)
Manual de Referncia
Close (Fechar)
O comando Fechar fecha um arquivo de entrada aberto e equivale a clicar no boto
(Fechar) da janela Viso geral ou clicar em [Nenhum] na caixa de dilogo Selecionar
arquivo de entrada. Consulte Caixas de dilogo selecionar/editar na pgina 40 do
ACL para Windows.
Voc no precisa fechar um arquivo de entrada para abrir outro. O ACL fecha automaticamente um arquivo de entrada antes de abrir outro. O arquivo a ser fechado pode ser
descrito de acordo com o tipo (primrio ou secundrio) ou pelo nome. Se nenhum
parmetro for especificado, o arquivo primrio ser fechado. Se voc estiver fechando
um arquivo de entrada primrio ou secundrio, o ACL ir remover todas as definies
de campo correspondentes do ambiente atual. Todas as alteraes feitas em definies
de registro so salvas antes do fechamento do arquivo. O ACL ir fechar automaticamente o arquivo de entrada, antes de executar os comandos Open (Abrir) e Quit (Sair).
Se voc tiver definido relacionamentos em seu Projeto ACL, o comando Fechar ir
fechar o arquivo primrio e todos os arquivos secundrios, alm dos arquivos relacionados.
Se voc estiver fechando um arquivo LEARN, o comando Fechar ir operar da mesma
maneira que a configurao Set Learn Off (Desativar Learn). Set Learn On/Off
(Ativar/Desativar Learn) e Open/Close Learn (Abrir/Fechar Learn) equivalem a
selecionar o menu Ferramentas e Ativar/Desativar o gravador de batch.
Nota: Voc no pode usar o comando Fechar para fechar um projeto ACL.
Para obter maiores informaes sobre como utilizar o Gravador de Batch, consulte
Criar batches na pgina 334 do Guia do Usurio do ACL para Windows.

CLOSE
CLOSE {PRIMARY|SECONDARY|LEARN|INDEX|LOG}
CLOSE nome-do-arquivo
INDEX fecha o ndice atual.
LOG retorna ao arquivo de Log ao padro.
PRIMARY fecha o arquivo primrio.
Captulo 4
Comandos
Comment (Comentrio)
141
SECONDARY fecha o arquivo secundrio.

LEARN fecha o arquivo Learn aberto atualmente.
Exemplo
Para abrir e fechar o arquivo primrio de contas a receber de nome Ar sem abrir um
arquivo diferente, digite CLOSE PRIMARY na caixa de texto do Log de comando.
A barra de status indicar que nenhum arquivo de entrada est aberto.
Comment (Comentrio)
Use o comando Comentrio para inserir uma observao ou explicao no arquivo de
Log do ACL sem afetar o processamento ou a execuo. O comando Comentrio
permite que voc documente uma sesso, incluindo itens como objetivos, descries e
outras explicaes necessrias. Voc pode usar Comentrio em batches ou grupos, para
incluir comentrios no Log.
Esse um mtodo eficiente para incluir documentao adequada, a fim de ajudar os
futuros usurios a determinar as operaes executadas e os resultados obtidos.
Quando no fizerem parte de um batch ou grupo, as linhas de comentrios so registradas no Log no momento em que so digitadas. Em um batch ou grupo, os comentrios so registrados como parte do arquivo de batch. Eles so includos no arquivo de
Log no momento em que o batch executado e exibidos no lugar apropriado dos resultados.
Caixa de dilogo Comentrio

Clique em
(Comentrio) ou selecione o menu Ferramentas e escolha Comentrio
para exibir a caixa de dilogo Comentrio.
142

Comment (Comentrio)
Manual de Referncia

COMMENT linha_de_comentrio
ou
COMMENT
linha de comentrio
linha de comentrio
...
linha de comentrio permite que voc digite um texto em um arquivo de log, em
um batch ou grupo.
Ao incluir mais que uma linha de comentrio, voc dever inserir uma linha em branco
aps a ltima linha de comentrio, para indicar que aquela a ltima linha de comentrio. Se voc no deixar uma linha em branco, o ACL ir considerar as linhas seguintes
como comentrios.
Exemplo
No ponto apropriado de um batch criado para fornecer uma viso geral bsica do
estoque antes de uma contagem de estoque, digite o seguinte na caixa de texto Comentrio:
TODOS OS VALORES NEGATIVOS REFERENTES QUANTIDADE
DISPONVEL DEVEM SER DISCUTIDOS COM O CONTROLADOR.
Aps a execuo do batch, o comentrio aparece nos resultados.
Captulo 4
Comandos
Count (Contar)
143
Os usurios subseqentes do batch podero seguir as instrues do comentrio. Voc

pode fazer comentrios to detalhados quanto quiser.
Count (Contar)
Use o comando Contar para contar o nmero de registros no arquivo de entrada atual
ou somente aqueles que atendem a uma condio de teste especfica.
Se nenhum teste for especificado, ser exibido o nmero total de registros do arquivo de
entrada. Se um filtro global tiver sido aplicado a uma exibio, o comando Contar ir
produzir o nmero de registros restantes no arquivo, aps ter sido aplicada a condio
do filtro.
O nmero total de registros existentes em um arquivo ou o nmero de registros correspondentes ao filtro global atual exibido no centro da barra de status.
O comando Contar armazena automaticamente seu resultado na varivel denominada
COUNTn (por exemplo, COUNT1). Quando o comando Contar for emitido como
parte de um grupo, o nmero de comando seqencial usado no nome da varivel n.
Por exemplo, se Contar o sexto comando no grupo, a varivel resultante nomeada
como COUNT6.
Parmetros
O comando Count (Contar) tem os seguintes parmetros: All (Tudo), First (Primeiros),
If (Se), Next (Prximo), While (Enquanto). Para a descrio desses parmetros,
consulte o Captulo 3: Parmetros de comandos comuns.
Caixa de dilogo Contar

Clique em
(Contar) ou selecione Analisar na barra de menus e escolha Contar para
exibir a caixa de dilogo Contar.
144

Define Field (Definir campo)
Manual de Referncia
Exemplo
Para contar o nmero de itens que possuem um valor registrado superior ao valor
estabelecido, digamos $15.000, use o comando Contar. Voc pode executar esse teste
para determinar o nmero de itens de estoque com um custo registrado que exceda um
valor predeterminado, como a materialidade ou preciso monetria. Voc pode
verificar fisicamente a existncia desses itens como parte de seus procedimentos gerais
de controle ou verificao do estoque.
Se, para verificar a preciso do sistema de contabilidade, todos os itens de estoque que
custam mais que $15.000 devem ser contados, ento devero ser realizados 10 testes.
Use Extrair com a mesma condio para armazenar esses registros em um arquivo
separado. Para obter mais informaes, consulte Extract (Extrair) na pgina 186.

COUNT <IF teste> <WHILE teste> <FIRST|NEXT intervalo>

Use o comando Definir campo para criar um campo no ACL.
ACL para Windows.
Definir campo permite que voc acrescente um campo sua definio de arquivo de
entrada. Voc somente pode definir campos calculados em um batch. Os campos calculados fazem parte da definio de arquivo de entrada.
Se j existir um campo com o mesmo nome, o ACL ir pedir confirmao antes de
substitu-lo. O ACL no permite que voc redefina um campo se ele for referenciado por
um campo calculado ou pela exibio atual.
Captulo 4
Comandos
145
Os campos podem conter tipos de dados sobrepostos. Por exemplo, voc pode definir
os bytes de 1 a 10 como um tipo de dado numrico. Voc pode em seguida definir a
mesma rea, ou parte dela, por exemplo, os bytes de 5 a 9, como um tipo de dado ASCII.
Nota: Para obter uma maneira mais direta e conveniente de definir campos, utilize a
janela Definio de arquivo de entrada, conforme descrito em Definir campos de dados
fsicos na pgina 155 do Guia do Usurio do ACL para Windows e Campos calculados
na pgina 160 do Guia do Usurio do ACL para Windows. Use essas tcnicas sempre que
possvel.
Parmetros
Alm do parmetro descrito abaixo, o comando Define Field (Definir) campos tem os
seguintes parmetros: As (Como), If (Se), Picture (Figura), Width (Largura). Para obter
uma descrio desses parmetros, consulte o Captulo 3: Parmetros de comandos
comuns.
Computed (Calculado)
Identifica o campo que est sendo definido como um campo calculado.

Voc deve incluir a definio completa de campo em uma nica linha de comando. O
ACL no solicita os parmetros.
DEFINE FIELD nome-do-campo tipo-do-campo posio-inicial
comprimento-do-campo <decimais|formato-de-data> <AS
"ttulo-alternativo-da-coluna"> <WIDTH> <PIC "formato">
Campos calculados
Voc pode definir campos calculados simples somente em um batch. Um exemplo de
campo calculado simples :
DEFINE FIELD VALOR COMPUTED CUSTO*QUANTIDADE
Isso define um novo campo Valor, para que seja o produto do campo Custo multiplicado
pelo campo Quantidade.
A sintaxe para campos calculados requer parmetros a serem digitados em linhas
mltiplas. Uma vez que a linha de comando no suporta comandos de linhas mltiplas,
voc precisa usar esse comando no modo batch para criar campos calculados.
Nos exemplos abaixo, o smbolo de retorno de carro () marca o final de cada linha de
um texto de linhas mltiplas. No digite um retorno de carro, exceto quando indicado
146

Manual de Referncia
pelo smbolo de retorno de carro. Se voc informar um retorno de carro antes do final
da linha, o comando no ir funcionar.
Campo calculado incondicional
DEFINE FIELDS nome-do-campo COMPUTED

AS "ttulo-alternativo-da-coluna" <WIDTH n> <PIC "formato">
expresso
Campos calculados condicionais

Coloque sempre o primeiro par de condio e valor na terceira linha. Deixe a segunda
linha em branco, se no estiver incluindo uma condio If, um modificador esttico,
uma descrio de campo, ou as clusulas As, Width, ou Pic.
DEFINE FIELD nome-do-campo COMPUTED
<IF condio> <STATIC> <AS descrio-do-campo> <WIDTH> <PIC
"formato">
<valor IF condio>
<valor IF condio>
<valor IF condio>
valor padro
Por exemplo, voc pode usar a seguinte sintaxe de campo calculado condicional para
substituir as abreviaes de estado por nomes de estado:
DEFINE FIELD nome-de-estado COMPUTED
"Alaska" IF estado = "AK"

"California" IF estado = "CA"
"Arizona" IF estado = "AZ"
"No um estado vlido "
nome-do-campo pode conter at 31 caracteres alfanumricos maisculos e mins-
culos, incluindo o caractere sublinhado (_). Para criar um nome de duas palavras,
preencha o espao entre as palavras com um caractere de sublinhado ou outro. Ao
nomear campos a partir de uma caixa de dilogo, o ACL insere automaticamente o
caractere de sublinhado entre as palavras.
tipo-do-campo identifica o tipo de campo apropriado. Consulte o Captulo 1: Tipos
de campo.
posio-inicial identifica a primeira posio do byte contando a partir de 1 e indo
da esquerda para a direita do campo que est sendo definido.

comprimento-do-campo especifica o comprimento em bytes do campo que est
sendo definido.
decimais aplica-se somente a campos numricos. Identifica o nmero de casas
decimais direita de qualquer vrgula decimal.
Captulo 4
Comandos
147
expresso pode ser qualquer expresso vlida do ACL. Consulte Exemplos de

expresses na pgina 282 do Guia do Usurio do ACL para Windows para obter mais
detalhes.
condio especifica a condio a ser cumprida.
STATIC permite que voc trate um campo como um campo esttico. Consulte
Campos condicionais calculados na pgina 164 do Guia do Usurio do
descrio-do-campo especifica o valor do ttulo alternativo da coluna.
valor especifica um valor baseado na condio.
valor padro especifica o valor se nenhuma das condies for cumprida.
Exemplo
Para definir um campo ASCII contendo nmeros de faturas chamados Invnum com
uma posio de incio no byte 1 e comprimento de 6 bytes:
1. Digite essa sintaxe na caixa de texto do Log de comando:
DEFINE FIELD Invnum ASCII 1 6
2. Pressione ENTER.
3. Voc pode verificar que o ACL definiu o campo ao selecionar Editar na barra de
menus e selecionando Definio de arquivo de entrada para exibir a janela
Definio de arquivo de entrada. A guia [Editar campos/expresses] relaciona o
campo recm-definido.
4. Selecione o campo, em seguida clique duas vezes nele para obter mais informaes
sobre o novo campo. A janela muda para mostrar o nome, tipo, posio inicial e
comprimento do campo definido. Os bytes que o campo ocupa tambm so destacados.
148

Define Relations (Definir relacionamentos)
Manual de Referncia
Aps fechar a janela Definio de arquivo de entrada, voc pode adicionar o campo
definido exibio, clicando em
(Adicionar colunas) para exibir a caixa de dilogo
Adicionar colunas. Para obter mais informaes sobre a adio de campos a exibies,
consulte Adicionar uma coluna a uma exibio na pgina 202 do Guia do Usurio do
ACL para Windows.
Define Relations (Definir relacionamentos)

Consulte Relations (Relacionamentos) na pgina 253.
Define Report (Definir relatrio)

A maneira mais rpida e fcil de produzir um novo relatrio e manter um j existente
trabalhar diretamente a partir de uma exibio. O comando Definir relatrio simplesmente um modo diferente de acessar a exibio na qual um relatrio est baseado.
Captulo 4
Comandos
Delete (Excluir)
149
Voc tambm pode usar o comando Definir relatrio para:
Mostrar uma exibio em branco, para permitir a criao de um novo relatrio,

se o nome da exibio usado no existir na DAE atual.
Mostrar uma exibio de relatrio da DAE atual, para permitir que voc
modifique um relatrio existente.
A criao de um relatrio a partir de uma exibio e todas as opes de formatao de

relatrios esto descritas em Relatrios na pgina 216 do Guia do Usurio do
ACL para Windows.
ACL para Windows.

DEFINE REPORT nome-da-exibio
nome-da-exibio permite que voc acesse uma exibio existente ou crie uma
nova exibio com o nome especificado. Se voc der exibio um nome composto com
duas palavras, certifique-se de incluir o caractere de sublinhado entre as mesmas.
Delete (Excluir)
Use o comando Excluir para remover arquivos, campos ou variveis indesejados do
ambiente ACL atual. Voc tambm pode usar o comando Excluir para excluir um
arquivo de dados. Por exemplo, DELETE TEMP.FIL.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
O item especificado removido onde estiver armazenado, por exemplo, no
Projeto ACL, em uma unidade local ou em uma unidade de rede, e se no est mais
acessvel. Voc no pode excluir um campo ou varivel ao qual um campo calculado faz
referncia, a menos que exclua primeiro o campo calculado. Alm disso, voc no
pode excluir um campo ao qual a exibio atual faz referncia.
A menos que especifique OK na linha de comando, voc ser solicitado a confirmar a
excluso de qualquer item. Haver uma solicitao de confirmao mesmo que a opo
Avisar antes de substituir arquivos na guia [Opes de interface] das Preferncias no
estiver selecionada.
150

Delete (Excluir)
Manual de Referncia
Voc pode usar Excluir no batch ou no Log de comando com qualquer palavra-chave
exibida a seguir.
Parmetros
O comando Delete (Excluir) tem os seguintes parmetros: All (Tudo), History
(Histrico), OK.
All (Tudo)
Indica que todas as variveis do ambiente ACL atual devem ser excludas. Os campos
no so afetados.
History (Histrico)
Exclui histricos do arquivo aberto no momento. Para salvar os histricos de um
arquivo de entrada existente antes de exclu-los, use o comando Display History. Voc
escolhe entre selecionar os histricos de arquivo e imprimi-los, ou copi-los e col-los
em um arquivo de texto. Se voc excluir o histrico de um arquivo de entrada, no pode
usar sua exibio para recriar o batch inteiro com a opo Criar batch a partir do
histrico do arquivo, em Ferramentas, na barra de menus. Entretanto, voc pode recriar
aquela poro do batch para a qual o histrico permanece.
OK
Indica que o comando dever ser executado sem confirmao.

DELETE
<OK>
DELETE
DELETE
DELETE
DELETE
DELETE
DELETE
DELETE
{nome-do-campo|nome-da-varivel|nome-do-arquivo|ALL}
HISTORY <nmero-a-ser-mantido>
RELATION <OK>
BATCH <nome-do-batch>
FORMAT <nome-da-definio-do-arquivo-de-entrada>
REPORT <nome-da-exibio>
WORKSPACE <nome-da-rea-de-trabalho>
INDEX <nome-do-ndice >
Nmero-a-ser-mantido indica o nmero dos histricos a manter. Voc pode usar o

comando Set History para definir o nmero mximo de histricos a manter. Por
exemplo, o comando Set History 4 significa que o nmero dos histricos mantidos
nunca passar de quatro.
FORMAT <nome-da-definio-do-arquivo-de-entrada> exclui a definio de
arquivo de entrada especificado, sua exibio padro, e seus ndices e relacionamentos
associados. Todas as outras exibies para a definio de arquivo de entrada especi-
Captulo 4
Comandos
Dialog (Dilogo)
151
ficado so mantidas. Se voc selecionar a preferncia Excluir arquivo de dados com a

Definio de arquivo de entrada na caixa de dilogo Editar preferncias do ACL, o
arquivo de dados vinculado definio de arquivo de entrada tambm ser excludo.
Exemplo 1
Para excluir um campo (QTYOO) contendo a quantidade dos itens de estoque no
pedido, digite DELETE QTYOO na caixa de texto do Log de comando.
O ACL exibe uma caixa de dilogo solicitando que voc confirme que deseja excluir o
campo.
Exemplo 2
Este batch executa um processamento cclico em um arquivo de entrada denominado
Demo e, por fim, executa o comando Delete History (Excluir histrico), retendo os
quatro ltimos histricos criados (aqueles criados no ltimo ciclo).
O smbolo retorno de carro () marca o final de cada linha do texto de mltiplas linhas.
OPEN DEMO
SORT ON PRODCLS PRODNO TO "SORTPROD"
OPEN SORTPROD
EXTRACT RECORD TO "SORTED" IF AMOUNT > 100
OPEN SORTED
EXTRACT ON COST ACCUMULATE MKTVAL PROFIT INTERVAL 10 TO
"STRATCOST"
OPEN STRATCOST
EXTRACT RECORD TO DEMO IF AMOUNT > 0
OPEN DEMO
DELETE HISTORY 4
Voc pode emitir o comando Delete History (Excluir histrico) em um batch, ou a

partir da janela do Log de comando, para excluir os histricos do arquivo de entrada
atualmente aberto.
Dialog (Dilogo)
Use o comando Dilogo para criar uma caixa de dilogo personalizada para interao
com o usurio em um batch. As caixas de dilogo personalizadas controlam o modo
como um batch executado, solicitando entradas e selees ao usurio. Onde for
possvel, coloque as caixas de dilogo no incio de um batch, de modo que os passos
restantes do batch possam prosseguir sem mais interrupes.
152

Dialog (Dilogo)
Manual de Referncia
Antes de usar o comando Dilogo ou o Construtor de dilogos, voc deve planejar seu
batch e ter um slido conhecimento de suas anlises e arquivos. Voc pode levar em
considerao as seguintes perguntas antes de iniciar:
O que eu quero que o batch faa?
Preciso de caixas de dilogo personalizadas para este batch?
Onde e como as caixas de dilogo personalizadas podem aumentar a utilidade e

a funcionalidade?
Quais informaes as caixas de dilogo personalizadas vo coletar?
Onde e como as informaes coletadas vo ser usadas?
Quais so os possveis erros que um batch pode encontrar e como poderei

trat-los?
Eu serei a nica pessoa a executar o batch ou outras pessoas iro execut-lo sem
minha assistncia?
Reserve alguns momentos para pensar sobre seus objetivos e determinar o que voc
deseja que as caixas de dilogo em seu batch faam. Uma abordagem excelente
desenhar o fluxo do batch antes de comear a constru-lo. Isso permite que voc se
concentre primeiro no funcionamento do batch e, em seguida, na interface para o
usurio.
Para obter mais informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows e Batches interativos na pgina 341 do Guia do Usurio do
ACL para Windows.
Construtor de dilogos
O Construtor de dilogos d acesso a todos os recursos do comando Dilogo. Ao usar o
Construtor de dilogos, voc pode estruturar caixas de dilogo personalizadas usando a
interface grfica. Ele oferece flexibilidade e controle para criar caixas de dilogo bastante
sofisticadas e personalizadas, que melhor se ajustem s suas necessidades. Voc pode
obter rapidamente uma vasta gama de informaes usando uma caixa de dilogo personalizada. Para fazer uso completo do Construtor de dilogos, voc deve estar familiarizado com os conceitos no Captulo 8: Automatizar o ACL no Guia do Usurio do
ACL para Windows Verso 7.
Captulo 4
Comandos
Dialog (Dilogo)
153
Criar uma caixa de dilogo personalizada

Para criar uma caixa de dilogo personalizada, siga esses passos:
1. Exiba a janela de batches executando um dos seguintes procedimentos:
Na janela Viso geral, clique em Batches e em
(Novo).
Na janela Viso geral, clique duas vezes no batch para o qual voc deseja criar
uma caixa de dilogo. O ACL perguntar se deseja editar ou executar o batch.
Clique em [Editar].
Construir novo dilogo
2. Na janela batch, clique em

(Construir novo dilogo). O ACL exibir o
Construtor de dilogos com um ttulo padro Caixa de dilogo do usurio.
Os botes [OK] e [Cancelar] esto colocados no canto direito superior, como
padro. Voc poder alterar o tamanho e a posio desses botes, mas no poder
exclu-los. Eles esto integrados funo de dilogo.
154

Dialog (Dilogo)
Manual de Referncia
Texto
Caixa de edio
Caixa de verificao
Boto de rdio
Lista suspensa
Lista deItens do Projeto
Excluir
Ajuste grade
rea de definio
Redimensionamento da tela
3. Clique duas vezes na rea de definio em branco. O ACL exibe a caixa de edio do
dilogo.
4. Informe um novo nome para a caixa de dilogo na caixa de texto Ttulo e clique em
[OK].
5. Adicione os controles. (Veja detalhes abaixo.)
6. Feche a janela do Construtor de dilogos. O ACL solicita Salvar alteraes para
caixa de dilogo?
7. Clique em [OK]. O ACL exibe a linha de comando do Construtor de dilogos na
janela do batch. Voc pode visualizar todos os controles na caixa de dilogo, rolando
para a direita.
Linha de comando do Construtor de dilogos
8. Feche a janela de batch. O ACL avisa que o batch foi alterado. Execute um dos
seguintes procedimentos:
Atualize o batch existente, deixando o nome destacado na caixa de texto

inalterada
Crie um novo batch informando um novo nome na caixa de texto
9. Clique em [OK].
Captulo 4
Comandos
Dialog (Dilogo)
155
Controles
Usando o Construtor de dilogos, voc pode construir controles nas caixas de dilogo
personalizadas que so usadas pelo batch para interagir com o usurio durante o
processamento. Voc pode criar os seguintes controles:
Mensagens de texto
Caixas de edio
Caixas de verificao
Botes de opo
Listas suspensas
Listas de itens do Projeto

Mensagem de texto
Listas suspensas
Marcas de grade
Caixa de edio
Lista de itens do
Projeto
Caixas de
verificao
Botes de
rdio
Voc pode alterar os parmetros ou caractersticas de cada controle atravs de sua caixa
de dilogo. Embora o escopo dos parmetros varie para cada tipo de controle, todos tm
parmetros de Posio e Tamanho. Esses parmetros permitem que voc especifique as
posies horizontal e vertical do canto superior esquerdo do controle e a altura e largura
do controle, em pixels. Assinale a caixa Auto para que o ACL redimensione automaticamente a caixa, quando seu contedo for alterado. Voc tambm pode alterar a Posio e
o Tamanho no prprio Construtor de dilogos. Para obter mais informaes, consulte
Editar controles na pgina 162.
Nota: Para obter uma aparncia mais consistente, mantenha as caixas Auto assinaladas
e a opo Ajuste grade ativa. As marcas de grade na rea de definio indicam que a
opo est ativa.
156

Dialog (Dilogo)
Manual de Referncia
Mensagens de texto
Uma mensagem de texto exibe um texto esttico que avisa ou informa o usurio.
Para adicionar uma mensagem de texto, faa o seguinte:
1. No Construtor de dilogos, clique em
(Texto) e, em seguida, clique na rea de
definio na qual deseja colocar a parte superior esquerda do controle. O ACL exibe
a caixa de dilogo Texto.
2. Digite a mensagem que deseja exibir na caixa de texto Rtulo. O comprimento

mximo da mensagem de 250 caracteres, incluindo espaos.
3. Especifique se a mensagem deve ser alinhada esquerda, no centro ou direita,
usando a opo Alinhamento.
4. Clique em [OK].
Caixas de edio
Use uma caixa de edio em seu batch para receber entradas do usurio. Esse controle
cria uma varivel de caractere.
Captulo 4
Comandos
Dialog (Dilogo)
157
Para adicionar uma caixa de edio, faa o seguinte:

(Caixa de edio) e, em seguida, clique na
rea de definio na qual deseja colocar a parte superior esquerda do controle. O
ACL exibe a caixa de dilogo Caixa de edio.
2. Digite o nome da varivel que conter o valor desse controle, na caixa de texto
Varivel.
3. Informe o texto na caixa Texto padro para determinar o valor padro da varivel.
4. Clique em [OK].
Caixas de verificao
Uma caixa de verificao apresenta opes de Falso ou Verdadeiro (Ativar ou Desativar)
ao usurio. Os usurios podem selecionar mais de uma opo dentro de um conjunto.
Esse controle cria uma varivel lgica que ser Verdadeira se a caixa de seleo estiver
assinalada e Falso, caso contrrio.
158

Dialog (Dilogo)
Manual de Referncia
Para adicionar uma caixa de verificao, siga os seguintes passos:

(Caixa de verificao) e, em seguida,
clique na rea de definio na qual deseja colocar a parte o superior esquerda do
controle. O ACL exibe a caixa de dilogo Caixa de verificao.
2. Digite o texto a ser exibido ao lado da caixa de verificao, na caixa de texto Rtulo.
3. Informe o nome da varivel que conter o valor desse controle, na caixa de texto
Varivel.
4. Selecione Marcada ou Desmarcada para determinar o valor padro da varivel.
5. Clique em [OK].
Botes de opo
Um conjunto de botes de opo apresenta opes mutuamente exclusivas ao usurio.
Somente uma opo pode ser selecionada em um conjunto de botes. Esse controle cria
uma varivel numrica que contm 1, se o primeiro boto de opo for selecionado, 2,
se o segundo boto de opo for selecionado, e assim por diante.
Captulo 4
Comandos
Dialog (Dilogo)
159
Para adicionar um conjunto de botes de rdio, faa o seguinte:

(Boto de opo) e, em seguida, clique na
ACL exibe a caixa de dilogo Boto de opo.
2. Digite o texto na caixa de texto Rtulo para criar um boto de rdio e o texto a ser
exibido ao lado dele.
3. Clique em [Adicionar] para adicionar o item Lista de rtulo.
4. Crie pelo menos um boto rdio a mais e adicione-o Lista de rtulo.
5. Digite o nome da varivel que dever conter o valor desse controle na caixa de texto
Varivel.
6. Destaque um item na caixa Lista de rtulo e clique em [Definir padro] para determinar o valor padro da varivel.
7. Especifique se os botes de rdio sero posicionados horizontalmente, lado a lado
ou verticalmente, um acima do outro, usando a opo Alinhamento.
8. Clique em [OK].
Listas suspensas
Uma lista suspensa apresenta uma lista de itens ao usurio. Somente um item pode ser
selecionado. Esse controle cria uma varivel de caractere que contm o texto do item
selecionado.
160

Dialog (Dilogo)
Manual de Referncia
Para adicionar uma lista suspensa, faa o seguinte:

(Lista suspensa) e, em seguida, clique na
ACL exibe a caixa de dilogo Lista suspensa.
2. Informe o texto na caixa de texto Rtulo para criar itens e clique em [Adicionar]
para adicion-los Lista de rtulo.
3. Digite o nome da varivel que dever conter o valor desse controle, na caixa de texto
Varivel.
4. Destaque um item na caixa Lista de rtulo e clique em [Definir padro] para determinar o valor padro da varivel.
5. Clique em [OK].
Listas de itens do projeto

Uma Lista de itens do projeto exibe uma lista suspensa dos itens que esto em seu
Projeto ACL. Somente um item pode ser selecionado. Esse controle cria uma varivel de
texto. Voc pode exibir uma ou mais definies, incluindo:
Campos de caractere, numricos, lgicos ou de data
Variveis de caractere, numricas, lgicas ou de data
Definies de arquivo de entrada
Batches
Exibies
reas de trabalho
Captulo 4
Comandos
Dialog (Dilogo)
161
ndices
Por exemplo, voc pode criar uma Lista de itens do projeto para exibir todas as
definies de arquivo de entrada. Quando o usurio seleciona uma definio de arquivo
de entrada, o batch pode usar um comando de macro para abrir essa definio e analisar
os dados. Para obter mais informaes sobre o uso de macros, consulte Macro de
substituio na pgina 349.
Para adicionar uma Lista de itens do projeto, faa o seguinte:
(Lista de itens do projeto) e, em seguida,
clique na rea de definio na qual deseja colocar a parte superior esquerda do
controle. O ACL exibe a caixa de dilogo Lista de itens do projeto.
2. Selecione os itens na lista suspensa Categoria e adicione-os Lista de categorias

clicando, em [Adicionar].
3. Digite o nome da varivel que conter o valor desse controle na caixa de texto
Varivel.
4. Digite um item da Lista de categorias na caixa de texto Padro, para determinar o
valor padro da varivel.
5. Clique em [OK].
162

Dialog (Dilogo)
Manual de Referncia
Editar controles
Para editar um controle, siga esses passos:
1. Clique duas vezes no controle. O ACL exibe a caixa de dialgo para edio do
controle.
2. Edite os parmetros para o controle.
3. Clique em [OK].
Voc pode alterar a posio de um controle no Construtor de dilogos clicando no
controle e arrastando para uma nova posio.
Voc pode alterar o tamanho de um controle no Construtor de dilogos clicando no
controle e arrastando seus redimensionadores de tela.
Nota: Para obter uma aparncia mais consistente, mantenha a opo Ajuste Grade
ativa. As marcas de grade na rea de definio indicam que a opo est ativa.
Excluir controles
Para excluir um controle, faa o seguinte:
1. Clique no controle para selecion-lo.
2. Clique em
(Excluir).
Editar uma caixa de dilogo personalizada

Voc pode editar uma caixa de dilogo personalizada enquanto ainda estiver trabalhando no Construtor de dilogos, ou aps voc ter adicionado a caixa a um batch.
Editar uma caixa de dilogo no construtor de dilogos

Para editar uma caixa de dilogo enquanto ainda estiver trabalhando no Construtor de
dilogos, siga esses passos:
1. Clique duas vezes em qualquer lugar na rea de definio onde no exista nenhum
controle. O ACL exibe a Caixa de dilogo do usurio.
Captulo 4
Comandos
Dialog (Dilogo)
163
2. Edite os parmetros para a caixa de dilogo.

3. Clique em [OK].
Voc tambm pode alterar o tamanho da caixa de dilogo arrastando o redimensionador de tela para o canto direito inferior da rea de definio.
Editar uma caixa de dilogo em um batch

Para editar uma caixa de dilogo aps ter adicionado a caixa a um batch, faa o seguinte:
1. Na janela Viso geral, clique duas vezes em um batch existente ou arraste o cone de
um batch existente para a rea de trabalho do aplicativo. O ACL exibir uma caixa de
dilogo solicitando Deseja editar ou executar o batch?
2. Clique em [Editar]. O ACL exibir a janela de batch.
3. Selecione o comando Dialog na linha de comando.
4. Clique em
(Editar comando). O ACL exibe o Construtor de dilogos criado por
esse comando.
5. Modifique a caixa de dilogo conforme a necessidade. Para obter mais informaes,

consulte Editar controles na pgina 162 e Excluir controles na pgina 162.
6. Salve suas alteraes no batch. Para obter mais informaes, consulte Criar uma
caixa de dilogo personalizada na pgina 153.
164

Dialog (Dilogo)
Manual de Referncia

A sintaxe do modo de comando para o comando Dialog (Dilogo) consiste em um
conjunto bsico de parmetros para cada controle, na caixa de dilogo personalizada.
Os conjuntos de parmetros esto entre parnteses. Como padro, um comando
Dilogo inclui um conjunto de parmetros para a prpria caixa de dilogo e o conjunto
de botes OK/Cancelar. Os conjuntos de parmetros para outros controles seguem o
conjunto de botes.
DIALOG (DIALOG TITLE "texto" WIDTH valor_px HEIGHT valor_px)
(BUTTONSET TITLE "&OK;&Cancelar" AT coord_x coord_y DEFAULT
nmero) other_parameter_sets
(CHECKBOX TITLE "texto" TO "varivel" AT coord_x coord_ y
WIDTH valor_ px HEIGHT valor_ px)
(DROPDOWN TITLE "item 1;item2;..." TO "varivel" AT coord_x
coord_y WIDTH valor_ px HEIGHT valor_ px DEFAULT nmero)
(EDIT PARA "EDIT1" AT coord_x coord_y WIDTH valor_ px HEIGHT
valor_ px DEFAULT texto)
(ITEM TITLE "indice_item" TO "varivel" AT coord_x coord_y
WIDTH valor_ px HEIGHT valor_ px DEFAULT
"categoria_do_item")
(RADIOBUTTON TITLE "item1;item2;..." TO "variable" AT
coord_x coord_y WIDTH valor_ px HEIGHT valor_ px DEFAULT
nmero)
(TEXT TITLE "texto" AT coord_x coord_ y WIDTH valor_ px
HEIGHT valor_ px)
texto especifica a cadeia de texto.
valor_ px especifica um valor de pixel.
coord_x coord_y especificam as posies horizontal e vertical do canto superior
esquerdo do controle.
nmero corresponde ordem na qual os itens so especificados. No conjunto de botes
OK/Cancelar acima, [OK] 1 e [Cancelar] 2.

varivel especifica o nome da varivel na qual o valor determinado pelo o usurio
mantido.
item1;item2;... especifica os rtulos para as opes no controle.
ndice_item especifica as categorias em uma Lista de itens de projeto. Cada categoria
representada por uma letra.
Captulo 4
Comandos
Display (Exibir)
165
categoria_do_item especifica a categoria padro do item do Projeto.
Sintaxe da categoria do item do projeto

Categoria do item do projeto
ndice
Batches
Campos de caractere
Variveis de caractere
Campos de data
Variveis de data
ndices
Definies de arquivo de entrada
Campos lgicos
Variveis lgicas
Campos numricos
Variveis numricas
Exibies
reas de trabalho
Display (Exibir)
Use o comando Exibir para exibir informaes sobre o ambiente ACL atual. As informaes exibidas dependem da palavra-chave que voc especifica.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Macro de substituio na pgina 349 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Display (Exibir) tem os seguintes parmetros: Date (Data), Free (Livre),
History (Histrico), Open (Abrir), Primary (Primrios), Secondary (Secundrios),
Relation (Relacionamentos), Space (Espao), Time (Hora), Variables (Variveis),
Version (Verso).
166

Display (Exibir)
Manual de Referncia
Date (Data)
Exibe a data e hora atuais, conforme definido pelo sistema operacional de seu computador.
Free (Livre)
Exibe a quantidade de memria (RAM) disponvel para uso. A quantidade exibida no
inclui a RAM reservada para variveis.
History (Histrico)
Exibe o histrico do arquivo, conforme descrito em File history (Histrico do
arquivo) na pgina 194.
Open (Abrir)
Exibe todos os arquivos abertos do Projeto ACL atual.
Primary, Secondary (Primrios, Secundrios)

Exibe os campos dos arquivos primrio ou secundrio abertos. Para cada campo na
definio de arquivo de entrada, so exibidas as seguintes informaes: nome, tipo do
campo, posio inicial, tamanho, casas decimais e explicao do campo. Para os campos
calculados, so exibidos o nome, o tipo de campo (COMPUTED) e a expresso de
definio, incluindo o valor padro.
Relation (Relacionamentos)
Exibe os arquivos relacionados na definio de arquivo de entrada.
Space (Espao)
Exibe a quantidade de memria (RAM) disponvel para uso; sinnimo de Livre.
Time (Hora)
Exibe a data e hora atuais, conforme definido pelo sistema operacional de seu computador e sinnimo de Data.
Variables (Variveis)
Exibe os valores das variveis definidas pelo comando Atribuir e os valores criados
automaticamente por certos comandos do ACL. Exibe tambm a quantidade de espao
restante para variveis adicionais.
Nota: A quantidade de espao padro para variveis de 60K. No entanto, o ACL
aumenta automaticamente a quantidade de espao disponvel para armazenar variveis,
quando necessrio.
Captulo 4
Comandos
Do Batch (Executar batch)
167
Version (Verso)
Exibe a verso do ACL que est sendo executada.

DISPLAY <PRIMARY>
DISPLAY SECONDARY
DISPLAY DATE |TIME
DISPLAY VARIABLES
DISPLAY HISTORY
DISPLAY FREE |SPACE
DISPLAY VERSION
DISPLAY OPEN
DISPLAY RELATION
Exemplo
Para exibir a definio de arquivo de entrada para o arquivo primrio, Inventory, digite
DISPLAY na caixa de texto do Log de comando.
O ACL exibe o resultado no Log de comando:

Use o comando Executar batch para executar um batch do ACL.
Voc tambm pode executar um batch simplesmente clicando duas vezes no nome do
batch na janela Viso geral e clicando em [Executar], na caixa de dilogo. Se voc
executar um batch a partir da janela Viso geral, no ter a opo de especificar um teste
Se.
No modo de comando, voc pode especificar testes If (Se) e While (Enquanto) em um
batch. Contudo, no possvel usar Se e Enquanto no mesmo comando Do Batch
168

Manual de Referncia
(Executar batch). O teste Se avaliado apenas uma vez, para determinar se o batch deve
ser executado e no aplicado individualmente para cada registro do arquivo. Se o teste
resultar em falso para o registro atual, o batch no ser executado. Portanto, voc no
poder colocar o comando Executar batch em um grupo. Veja as explicaes de Se e
Enquanto a seguir.
Nota: Se voc descobrir que seu arquivo de batch no est como voc queria, possvel
edit-lo. Clique duas vezes no nome exibido na janela Viso geral e selecione [Editar].
Ao digitar em uma janela de batch, voc pode desfazer a ltima digitao pressionando
CTRL-Z.
Para obter mais informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Do Batch (Executar batch) tem os seguintes parmetros de comando
comuns: If (Se), While (Enquanto). Para obter uma descrio, consulte o Captulo 3:
Parmetros de comandos comuns.
Caixa de dilogo Executar batch

Clique em
(Executar batch) ou selecione Ferramentas na barra de menus e selecione
Executar batch para exibir a caixa de dilogo Executar batch. A caixa de listagem
Executar batch permite que voc selecione o batch a ser executado. Se nenhum batch
tiver sido criado, ela aparecer vazia.
Exemplo
Para executar um batch, Inventory_count_prep, que fornece uma viso geral bsica do
estoque antes de realizar uma contagem de estoque, use Executar batch.
Selecione Inventory_count_prep na caixa de dilogo Executar batch.
Captulo 4
Comandos
169
Os resultados so exibidos no Log de comando.

DO <BATCH> nome_do_batch <IF teste|WHILE teste>
Se voc usar um teste WHILE em um comando Do Batch, a velocidade de processamento

substancialmente mais lenta, uma vez que os comandos no batch so repetidos para
cada chamada feita.
Ao usar WHILE em um comando, Do Batch certifique-se de que seu teste eventualmente
resulte em falso, uma vez que no h nenhuma proteo contra loops infinitos. Se
voc acabar criando um loop infinito, pressione ESC para interromp-lo.
170

Do Report (Executar relatrio)
Manual de Referncia
Do Report (Executar relatrio)

Semelhante a clicar em [Sada] e selecionar Imprimir na caixa de dilogo Relatrio, a
emisso do comando Do Report (Executar relatrio) imprime um relatrio. O relatrio
enviado diretamente para a impressora.
Nota: Todos os recursos de gerao de relatrio do ACL so acessveis pelas caixas de
dilogo.
Para obter uma descrio mais detalhada dos recursos de gerao de relatrios do ACL,
consulte Relatrios na pgina 216 do Guia do Usurio do ACL para Windows.
ACL para Windows.

DO REPORT nome_do_relatrio
nome-do-relatrio permite que voc especifique o relatrio a ser impresso. Como
um relatrio gerado a partir de uma exibio, digite o nome da exibio como sendo o
valor para esse parmetro. Se o nome da exibio for composto de duas palavras, certifique-se de incluir o caractere de sublinhado entre elas.
Dump (Descarregar)
Use o comando Dump (Descarregar) para exibir o contedo de um arquivo especificado ou do registro atual em formato hexadecimal, ASCII e EBCDIC.
O comando Descarregar til se voc tem problemas para definir um formato ou
encontrou dados invlidos no arquivo.
Nota: Voc no pode emitir o comando Descarregar por meio de um batch.
Parmetros
O comando Dump (Descarregar) tem os seguintes parmetros: ASCII, Columns
(Colunas), EBCDIC, File (Arquivo), Find (Localizar), HEX, Horizontal, Position
(Posio), Record (Registro), Refresh (Atualizar), Skip Bytes (Ignorar bytes).
Captulo 4
Comandos
Dump (Descarregar)
171
ASCII
Exibe dados em formato ASCII.
Columns (Colunas)
Altera a largura da exibio. Consulte COLUMNS no comando Sintaxe do Modo de
Comando abaixo.
Para alterar a largura da exibio, informe um nmero na caixa de texto, ou clique nos
controles para cima e para baixo ao lado da caixa de rolagem Colunas, para aumentar ou
diminuir o nmero de bytes exibidos em cada linha.
EBCDIC
Exibe os dados no formato EBCDIC.
File (Arquivo)
Exibe o contedo de um arquivo em um ou mais dos formatos hexadecimal, ASCII, e
EBCDIC. Quando voc seleciona Arquivo, o ACL exibe uma caixa de dilogo Abrir,
permitindo escolher o arquivo que deseja.
Find (Localizar)
Localiza um valor especificado nos dados. Por exemplo, para localizar o valor 39 no
formato hexadecimal:
1. Na caixa de dilogo Descarregar, clique em [Localizar] para exibir a caixa de dilogo
Localizar.
172

Dump (Descarregar)
Manual de Referncia
2. Digite 39 na caixa de texto Localizar, selecione o boto da opo HEX e, em seguida,

clique em [Localizar]. A caixa de dilogo Descarregar mostra o valor hexadecimal
39 selecionado.
HEX
Exibe dados em formato hexadecimal.
Horizontal
Exibe os dados em formato horizontal. Consulte HORIZONTAL na Sintaxe de Modo de
Comando abaixo.
Position (Posio)
Mostra qual byte est selecionado no momento.
Record (Registro)
Exibe o contedo de um registro em formatos hexadecimal, ASCII e EBCDIC. Voc
pode selecionar uma ou mais dessas opes de formato.
Refresh (Atualizar)
Leva voc at o incio da exibio do comando Descarregar (Dump), se o incio do
arquivo estiver fora da exibio.
Skip Bytes (Ign. bytes)

Permite que voc ignore um nmero especificado de bytes antes de descarregar os
dados. Digite o nmero de bytes a ignorar, na caixa de rolagem Ign. bytes.
Caixa de dilogo Descarregar

Clique em
(Descarregar) ou selecione Ferramentas, na barra de menus e escolha
Descarregar para exibir a caixa de dilogo Descarregar.
Captulo 4
Comandos
Dump (Descarregar)
173

No modo de comando, voc pode exibir um arquivo ou um registro de um arquivo
atualmente aberto.
Para exibir um arquivo em blocos de 16 caracteres na tela, em formato hexadecimal
ASCII e EBCDIC:
DUMP nome-do-arquivo <SKIP n>
<COLUMNS c>
<HORIZONTAL>
Para exibir o contedo do registro atual no arquivo primrio em formatos hexadecimal

ASCII e EBCDIC quando um arquivo primrio j estiver aberto:
DUMP RECORD
<COLUMNS c>
<HORIZONTAL> TO nome-do-arquivo
Para exibir um registro em particular, use o comando Locate (Buscar). Por exemplo, se
voc digitar LOCATE RECORD 13 na linha acima do Dump Record, o Dump exibe o
registro 13.
nome-do-arquivo especifica o nome do arquivo que voc deseja exibir.
SKIP n especifica quantos bytes ignorar antes de se descarregar os dados. O padro 0.
COLUMNS especifica a largura da sada, em termos de nmero de bytes a serem exibidos
em cada linha. No modo padro desse comando, a largura real da exibio aproximadamente quatro vezes a largura de Colunas, j que os dados so exibidos em formatos
hexadecimal, ASCII e EBCDIC. Para exibies horizontais, a largura de aproximadamente 12 caracteres maior que o valor de COLUMNS. O padro 16 para exibio
vertical e 64 para exibio horizontal.
174

Duplicates (Duplicidades)
Manual de Referncia
HORIZONTAL exibe os dados em formato horizontal sobre e sob, em vez do padro
vertical de formato lado a lado.

RECORD especifica que o contedo do registro atual deve ser exibido.
O comando Duplicidades uma variao do comando Seqncia e usado para
detectar se os campos-chave do arquivo atual contm duplicidades na seqncia.
Voc pode tambm assinalar a caixa Duplicidades, na caixa de dilogo do comando
Seqncia. Entretanto, a seleo do comando Duplicidades faz com que o ACL selecione
a caixa de seleo Duplicidades como padro.
Para obter mais informaes, consulte Sequence (Seqncia) na pgina 298.
Parmetros
O comando Duplicates (Duplicidades) tem os seguintes parmetros de comando
comuns: All (Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File Type
(Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir),
Screen (Tela), While (Enquanto). Para obter uma descrio, consulte o Captulo 3:
Para obter a descrio de outros parmetros, consulte Parmetros na pgina 299.
Captulo 4
Comandos
Else (Seno)
175
Caixa de dilogo Duplicidades

Clique em
(Duplicidades) ou selecione Analisar na barra de menus e selecione
Duplicidades para exibio da caixa de dilogo Duplicidades.
Exemplo
Consulte Exemplo 1 na pgina 301.
Else (Seno)
Use o comando Seno para obter um conjunto alternativo de comandos quando um
teste Grupo Se falhar em um grupo condicional. O comando Seno tambm pode ter
sua prpria condio.
Seno usado somente em um grupo, nunca sozinho. Como os grupos so usados
apenas em batches, esse comando s estar disponvel quando uma janela de batch
estiver aberta.
O comando Seno s permitido se o comando Grupo associado contiver um teste.
Neste caso, para cada registro de um arquivo, os comandos entre Grupo e Seno sero
processados se o teste for bem-sucedido, e os comandos entre Seno e Fim sero processados se o teste falhar.
importante observar que todos os comandos so executados, mas dependendo do
valor do teste, somente um dos conjuntos de comandos ser executado para cada
registro. Para obter mais informaes, consulte Grupos na pgina 340 do
Parmetros
O comando Else (Seno) tem o seguinte parmetro comum: If (Se). Para obter a
descrio, consulte o Captulo 3: Parmetros de comandos comuns.
Caixa de dilogo Seno

Clique em
(Seno) em uma janela de batch para exibio da caixa de dilogo Seno.
176

End (Fim)
Manual de Referncia
Exemplo
Consulte Group (Grupo) na pgina 198.

ELSE <IF teste>
End (Fim)
Clique em
(Fim) em uma janela de batch para inserir o comando Fim para fechar
ou finalizar um comando Grupo ou Loop.
Fim somente usado em um grupo; nunca sozinho. Como os grupos so usados somente
em batches, este comando est disponvel apenas quando uma janela de batch estiver
aberta. Para obter mais informaes, consulte Grupos na pgina 340 do

END
Exemplo
Consulte Group (Grupo) na pgina 198.
Evaluate (Avaliar)
O comando Avaliar determina o impacto dos erros de amostragem detectados em uma
populao para um nvel de confiana especificado e estabelece o cenrio do pior
Captulo 4
Comandos
Evaluate (Avaliar)
177
caso, retornando uma freqncia de limite de erro superior para uma amostragem de
registros e um limite de erro superior para uma amostragem monetria.
Nota: Antes de usar Avaliar, voc deve determinar o tamanho da amostra usando o
comando Tamanho do ACL e deve j ter extrado a amostra, usando o comando Amostra
do ACL.
Use Avaliar para determinar o efeito dos erros detectados nos resultados da amostragem
de registros ou monetria.
Na amostragem de registros, a freqncia do limite de erro superior expressa

como uma taxa de erro, uma vez que os resultados so baseados em nmero de
erros e no em valores monetrios. Por essa razo, a freqncia de limite de erro
aparece no Log de comando como um percentual.
Na amostragem monetria, o limite de erro superior (LES) expresso como um
valor monetrio. O erro mais provvel fornece o valor do erro esperado na
populao. O limite de erro superior fornece cenrio do pior caso.
Nota: A teoria por trs da amostragem estatstica complexa. Se no estiver familiarizado com os julgamentos crticos necessrios para a realizao de uma amostragem
estatstica, recomendamos que consulte um especialista em estatstica antes de usar os
comandos Tamanho, Amostra e Avaliar do ACL.
Nota: Na amostragem por unidade monetria voc pode usar o Avaliar somente para o
mtodo de amostragem de intervalos. Em amostragens por registro, voc pode us-lo para
qualquer mtodo.
O comando Avaliar usa os parmetros da amostragem original e qualquer erro encontrado na amostra para calcular o limite de erro superior para a populao.
Para amostras de registros, o LES o limite de erros (expresso na forma de percentual)
que voc garante que no ser excedido. Por exemplo, voc pode ter 90% de confiana
que a taxa total de erros no exceda 6,5%.
Para amostras monetrias, os erros registrados so processados e relatados em detalhes.
O relatrio inclui os efeitos de cada erro e mostra a quantidade mais provvel de erros
totais, e o LES expresso como uma quantia monetria. Esse o montante que voc est
seguro de que no ser excedido no total de erros. Por exemplo, voc pode fazer uma
estimativa de que os erros mais provveis somaro 50.000, mas tambm pode estar 95%
seguro de que o total de erros no exceder 288.000.
Na avaliao de erros de amostragem, o ACL usa os fatores cumulativos do limite de
erro superior da distribuio de Poisson.
178

Evaluate (Avaliar)
Manual de Referncia
Avaliao da amostra de registro

O ACL utiliza a seguinte frmula para avaliar erros de registro:
Freqncia do limite de erro superior =
LES cumulativo
Tamanho da amostra
O tamanho da amostra fornecido e o fator cumulativo de LES determinado a partir

da distribuio de Poisson, com base no nmero de erros fornecido e no nvel de confiabilidade.
Avaliao de amostra monetria

O ACL usa uma frmula ligeiramente mais complexa para avaliar erros monetrios,
porm ela tambm se baseia nos fatores cumulativos de LES para a distribuio de
Poisson:
A preciso bsica a quantidade de erros a qual confiamos no exceder, se

nenhum erro for relatado para a amostra. Isso determinado, multiplicando-se
o intervalo de amostragem pelo fator LES de Poisson para a confiabilidade
especificada (assumindo que no haja erros).
Para cada erro inserido, o percentual de erro determinado, dividindo-se o valor
do erro pelo valor registrado do item.
Para cada erro inserido, determinada uma estimativa do erro mais provvel na
populao.
Para os itens menores que o intervalo de seleo, o erro mais provvel o
percentual de erro multiplicado pelo intervalo usado para a seleo. Esse clculo
baseia-se no fato de que o item especfico selecionado no estava automaticamente selecionado e, portanto, representativo para outros erros na populao.
Para os itens iguais ou maiores que o intervalo (itens de camada superior), o erro
mais provvel o valor do erro. A frmula anterior no se aplica porque todos os
itens da camada superior esto selecionados e, portanto, o erro no representativo de outros da populao.
Quando for completada a entrada de erros, os erros sero ordenados em

seqncia decrescente pelo valor do erro mais provvel, com os itens de camada
superior e os itens subavaliados listados no final.
Um fator de ajuste de preciso calculado para cada erro.
Para os itens menores que o intervalo de amostragem, o fator de ajuste de
preciso o erro mais provvel multiplicado pelo fator cumulativo de LES
referente quele nmero de erro nas tabelas de Poisson. Essa reordenao dos
erros combina os maiores erros aos maiores fatores de ajuste, garantindo a
estimativa mais alta do limite de erro superior.
Captulo 4
Comandos
Evaluate (Avaliar)
179
Para os itens de camada superior, o fator de ajuste de preciso o valor do erro.

Como todos os itens de camada superior so selecionados, todos os itens dessa
populao (e, presumivelmente, todos os erros) so detectados.
Para erros de subavaliao, o fator de ajuste de preciso zero. Isso significa que
a estimativa de limite de erro superior no reduzida quando forem detectadas
subavaliaes, j que esse tipo de erro no diretamente testado com uma
amostra monetria.
Nota: Diversas metodologias de avaliao de amostra usam valores de ajuste para os
fatores de subavaliao, variando de zero (como no ACL) at o valor de erro mais provvel.
Se voc preferir usar uma hiptese diferente em relao ao tratamento de erros de subavaliao, pode facilmente ajustar o detalhe fornecido para que reflita sua reduo no limite de
erro superior. Isso no afeta a estimativa de erro mais provvel, que permanece a mesma,
independente das hipteses sobre subavaliaes.
Por fim, os erros mais provveis so acumulados para produzir o total de erros
mais provveis para os erros de amostra observados. Do mesmo modo, a
preciso bsica somada a todos os fatores de ajuste de preciso referentes aos
erros observados, a fim de produzir o limite de erro superior para a amostra
dentro da confiabilidade exigida.
Parmetros
Alm dos parmetros descritos abaixo, o comando Evaluate (Avaliar) tem os seguintes
parmetros: File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Graph
(Grfico), Header (Cabealho), Local (Local), Name (Nome), Print (Imprimir), Screen
(Tela), To (Para). Para obter uma descrio desses parmetros, consulte Captulo 3:
Monetary (Monetrio)
Especifica o tipo de amostragem monetria.
Record (Registro)
Especifica o tipo de amostragem de registros.
Confidence (Confiabilidade)
Especifica o nvel de confiabilidade, informado como um percentual.
Interval (Intervalo)
Especifica o intervalo de amostragem utilizado para a extrao da amostra. Consulte
Amostragem por intervalo fixo na pgina 280.
180

Evaluate (Avaliar)
Manual de Referncia
Errors (Erros)
Especifica o valor registrado para o item da amostra e o valor do erro associado quele
item. Por exemplo, se o valor registrado 700, mas deveria ter sido 900, o item valor
700 e o valor de erro 200. Ao digitar, separe os dois valores com um ponto e vrgula.
Para amostragem por unidade monetria, informe valores positivos para erros de
superestimao e valores negativos para erros de subestimao. Por exemplo:
Se o valor do amostrado 100, mas a investigao mostra que deveria ser 75, o
item est superestimado em 25. Digite 100;25 na caixa de texto Erros.
Se o valor do amostrado 100, mas deveria ter sido 125, esse item est subestimado. Digite 100;25 na caixa de texto Erros.
Voc registra o valor subestimado como negativo, uma vez que o oposto do
superestimado.
Sample Size (Tamanho da amostra)

Especifica o nmero de registros que foram testados.
Number of Errors (Nmero de erros)

Especifica o nmero de erros encontrados na amostra que voc est avaliando.
Caixa de dilogo Avaliar

Clique em
(Avaliar) ou selecione Amostragem na barra de menus e escolha Avaliar
para exibir a caixa de dilogo Avaliar. Como padro, o ACL exibe as opes para a
amostragem por unidade monetria.
Captulo 4
Comandos
Evaluate (Avaliar)
181
Para exibir as opes para amostragem de registros, clique no boto de opo Registro.
Exemplo 1
Para avaliar o limite de erro superior para uma amostra de registros com 95% de confiabilidade, dado um tamanho de amostra de 120 e 3 erros encontrados na amostra:
Digite o nvel de confiabilidade

Digite o nmero de itens de amostra testados
Digite o nmero de erros encontrados na amostra
O resultado exibido no Log de comando.
Voc pode ter 95% de confiabilidade de que a taxa de erros na populao no excede
6,47%.
Exemplo 2
Para avaliar o limite de erro superior para uma amostragem monetria com 90% de
confiana, dado um intervalo de amostragem de 300.000 e trs valores de item e de erro.
182

Evaluate (Avaliar)
Manual de Referncia
Digite o nvel de confiabilidade

Digite o intervalo utilizado para a amostra testada
Digite o valor registrado do item da amostra, e o

valor do erro encontrado nesse item.
A preciso bsica de 693.000. Em sua avaliao, voc especificou um intervalo

monetrio de 300.000 e um nvel de confiabilidade de 90%. A preciso bsica permite
que voc faa a melhor estimativa que puder: que voc tem 90% de confiabilidade de
que o total de erros no exceda 693.000 se nenhum erro for relatado na amostra.
Admitindo-se que tenham sido relatados trs erros, a estimativa de maior probabilidade
do total de erros na populao de 131.742,86 e voc poder ter 90% de confiabilidade
de que o total de erros no exceder 892.429,72.
Nos resultados, o erro de 12.000 no item 500.000 permanece inalterado nas colunas Erro
Mais Provvel e Limite de Erro Superior, j que se trata de um item de camada superior.
Um item de camada superior aquele cujo valor maior que o intervalo de amostragem
especificado. Como todos os itens de camada superior so selecionados automaticamente, presume-se que todos os erros nesses itens tambm sejam relatados e que no
haja necessidade de projeo estatstica.
O erro de 250 no item 700 resulta no maior ajuste aos erros relatados. Isso acontece
porque o erro de 250 representa o maior percentual de erro (36%) e, portanto, resulta no
maior ajuste quando estatisticamente projetado.
Captulo 4
Comandos
Export (Exportar)
183

EVALUATE RECORD CONFIDENCE nvel-de-confiabilidade SIZE
tamanho-da-amostra ERROR nmero-de-erros
EVALUATE MONETARY CONFIDENCE nvel-de-confiabilidade
ERRORLIMIT valor-do-item; erro
INTERVAL intervalo-monetrio
Export (Exportar)
Use o comando Export para criar arquivos que sero utilizados em:
Bancos de dados
Programas de apresentao de grficos
Programas de planilha eletrnica
Processadores de texto
O comando Export permite que voc converta dados de campos selecionados nestes
formatos:
Texto delimitado
dBASE III PLUS
Lotus 1-2-3
Microsoft Access 2000
Microsoft Excel
Arquivos mesclados do Microsoft Word
Texto simples
rea de transferncia do Windows para colar em outros aplicativos Windows
Arquivos mesclados do WordPerfect 4,1 ou do WordPerfect 6,0
XML
O comando Export permite que voc use o ACL como uma ferramenta de converso de
dados, obtendo dados de um pacote e produzindo um arquivo de exportao em um
formato que possa ser lido por outro pacote.
O comando Export freqentemente usado como a ltima etapa na produo de cartas
de confirmao. Por exemplo, voc pode usar o comando Size para determinar seu
intervalo de amostragem e, depois, usar Sample para criar uma amostra apropriada. Por
fim, voc pode usar Export para converter o arquivo de amostra de resultado em um
arquivo .doc do Word que pode ser usado em operaes de mesclagem do Word.
184

Export (Exportar)
Manual de Referncia
Criando arquivos do MS Excel e do MS Access

Voc pode usar o comando Export para criar arquivos do Microsoft Excel ou bancos de
dados do Microsoft Access. Export mantm a formatao e o tipo dos campos, desde
que tenham sido especificados durante o processo de definio. O ACL para Windows
no requer que voc tenha o Excel ou o Access instalados no seu computador para
exportar arquivos nesses formatos.
Voc pode optar por exportar seus dados no formato do Excel 2,1 ou em outro formato
do Excel. No menu suspenso Export As, Excel denota a verso mais recente do Excel
para a qual o ACL para Windows d suporte (atualmente, Excel 2000).
Voc pode controlar o modo como seus dados so exportados para o Access. possvel
optar entre:
Criar um novo banco de dados do Access 2000. Seus dados so includos em uma
nova tabela.
Exportar seus dados para um banco de dados existente do Access 2000. Voc
pode criar uma nova tabela ou sobrescrever uma j existente. Voc pode determinar que um aviso seja exibido antes de sobrescrever. Para obter mais informaes, consulte Avisar antes de substituir arquivos na pgina 312 do
Exportando XML
Voc pode exportar seus dados em XML usando o comando Export. O XML resultante
pode ser editado em qualquer processador de texto e pode ser usado por qualquer
sistema de processamento ou aplicativo XML.
Utilizao de exportar com o Sistema ACL Cliente/Servidor

Durante uma sesso ativa, Export sempre direciona a sada para o cliente. Portanto,
voc no pode exportar arquivos para o servidor. Para criar um conjunto de dados que
possa ser usado no servidor, use Extract em lugar de Export. Para obter mais informaes, consulte Extract (Extrair) na pgina 186.
Parmetros
O comando Export (Exportar) tem os seguintes parmetros: All (Tudo), Append
(Anexar a um arquivo existente), File (Arquivo), File Type (Tipo de Arquivo), First
(Primeiros), If (Se), Local (Local), Next (Prximo), To (Para), While (Enquanto). Para
uma descrio desses parmetros, consulte Captulo 3: Parmetros de comandos
comuns.
Captulo 4
Comandos
Export (Exportar)
185
Caixa de dilogo Exportar

Clique em
(Exportar) ou selecione Dados na barra de menus e escolha Exportar
para exibir a caixa de dilogo Exportar.
Exemplo
Use Exportar para produzir cartas de confirmao.
Voc tem informaes em um arquivo personalizado de que necessita para confirmaes de endereo, mas o arquivo no est formatado do modo que voc gostaria.
Para alterar o formato, voc pode exportar o arquivo para um arquivo secundrio para
mesclagem, a fim de ser utilizado em um programa de processamento de texto, como o
186

Extract (Extrair)
Manual de Referncia
Microsoft Word. Exporte todos os campos, exceto o campo de limite de crdito, que no
necessrio para produzir as confirmaes.
O novo arquivo Customer_master est agora pronto para ser usado em mesclagens no
Microsoft Word, sem edies e formataes.

Na sintaxe de comando a seguir, Excel representa a verso do Excel mais recente para
a qual o ACL para Windows d suporte e XLS21 representa o Excel 2,1.
Nota: Se voc estiver usando o parmetro Excel em um lote, deve verificar se no seu
sistema est instalada a verso mais recente do Excel para a qual o ACL para Windows d
suporte.
EXPORT <FIELDS> lista_de_campos TO criar_nome_de-_arquivo
{ASCII|DBASE|DELIMITED|LOTUS|WORD|WP|WDPF6
|CLIPBOARD|ACCESS|EXCEL|XLS21|XML}
<APPEND>
Extract (Extrair)
Use o comando Extrair para extrair registros ou campos selecionados do arquivo atual e
copi-los para um arquivo diferente.
H vrios motivos para usar Extrair na criao de um subconjunto de um arquivo
original. Por exemplo, voc pode usar Extrair antes de ordenar um arquivo, a fim de
Captulo 4
Comandos
Extract (Extrair)
187
reduzir o seu tamanho e o tempo de processamento. Voc tambm pode usar Extrair
para isolar itens incomuns em um arquivo separado para anlise posterior.
possvel extrair registros inteiros do arquivo de entrada, incluindo quaisquer dados
armazenados em reas indefinidas na definio de arquivo de entrada. As definies de
campo no arquivo de destino so idnticas quelas do arquivo fonte, incluindo
quaisquer definies de campos calculados.
Nota: A extrao de registros de um arquivo que contm campos estticos e/ou estticos
condicionais pode gerar resultados imprevistos. Certifique-se de selecionar apenas os
campos desejados.
Voc tambm pode extrair campos especificados de um registro. Quando voc escolhe
essa opo, o ACL gera automaticamente definies de campo para o arquivo de
destino. Os campos calculados includos na lista de campos so analisados antes da
extrao, de modo que formem parte da definio de arquivo de entrada no arquivo de
destino. Seus tipos de campos sero Lgico, Data, ASCII ou ACL, em vez de
Computado. Esse arquivo ter Comprimento de Registro fixo.
Nota: Se voc selecionar todos os campos da caixa de listagem Extrair, o resultado poder
no ser idntico ao de extrair um registro. A seleo de campos dessa forma ignora todas as
partes indefinidas do registro. Ao extrair um registro inteiro, voc extrai at mesmo as
partes indefinidas.
Nota: Ao processar arquivos do servidor que contm arquivos relacionados, a sada tipo
registro ser alterada para todos os campos de sada, se voc especificar a opo ou
palavra-chave local.
Parmetros
Alm do parmetro descrito abaixo, o comando Extract (Extrair) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), End Of File (Fim de
arquivo), Fields (Campos), First (Primeiros), If (Se), Next (Prximo), Record
(Registro), While (Enquanto). Para a descrio desses parmetros, consulte o
Extrair campos
Permite selecionar os campos ou expresses a serem extrados. Voc pode destacar os
campos na caixa de listagem Extrair campos ou clicar em [Extrair campos] para abrir a
caixa de dilogo Campos selecionados. Consulte Caixas de dilogo selecionar/editar
na pgina 40 do Guia do Usurio do ACL para Windows.
188

Extract (Extrair)
Manual de Referncia
Os campos calculados so convertidos para o tipo de campo apropriado no arquivo

criado: ACL, ASCII, Data ou Lgico.
Caixa de dilogo Extrair

Clique em
(Extrair) ou selecione Dados, na barra de menus, e escolha Extrair para
exibir a caixa de dilogo Extrair.
Exemplo 1
Se voc descobrir que um arquivo de estoque tem valores negativos para a quantidade
disponvel ou valor registrado, voc pode querer extrair esses registros excepcionais
para um novo arquivo, Negative_value, para investigao posterior.
Captulo 4
Comandos
Extract (Extrair)
189
Os registros que atenderem ao teste de valor negativo aparecero no novo arquivo.
Exemplo 2
Para criar um arquivo que contenha somente os campos que voc considere teis para
suas anlises, use Extrair. Lembre-se de selecionar os campos na ordem em que devem
aparecer em sua exibio.
Extraia os campos para classe de produto, descrio de produto, nmero do produto,
quantidade disponvel e valor registrado para o arquivo Inventory_extract (nem todos
os campos selecionados esto visveis na caixa de listagem do exemplo.)
190

Extract (Extrair)
Manual de Referncia
Os registros extrados aparecem na Exibio Padro do Inventory_extract.

EXTRACT {RECORD|<FIELDS> campos_a_serem_extrados} TO
nome-do-arquivo-a-ser criado
<IF teste> <WHILE teste>
<FIRST|NEXT intervalo>
<EOF>
<APPEND><OPEN>
Captulo 4
Comandos
Fieldshift (Deslocar campos)
191

O comando Deslocar campos permite que voc desloque a posio inicial de um campo
de dados. Por exemplo, se os campos de dados so adicionados ou removidos de um
arquivo fonte em qualquer posio antes do final, os dados em campos previamente
definidos freqentemente saem de alinhamento. Voc pode usar Deslocar campos para
realinhar esses campos de dados. Ao deslocar a posio inicial de um campo de dados,
voc automaticamente desloca a posio inicial daquele campo juntamente com todos
os campos de dados sua direita.
Deslocar campos somente desloca campos de dados fsicos. Uma vez que campos calculados so campos virtuais que se referem a outros campos, eles no so afetados.
Voc pode deslocar campos de dados usando o boto Deslocar campos na guia [Editar
campos/expresses] da janela Definio de arquivo de entrada, ou usar o modo de
comando.
O ACL no permite que voc desloque campos de dados quando essa ao fizer com que
os campos deslocados se estendam alm do comprimento do registro atual. Como
resultado, pode ser necessrio aumentar o comprimento do registro na guia [Opes do
arquivo de entrada] na janela Definio de arquivo de entrada, antes de deslocar os
campos.
Se o campo de dados tiver sido removido do arquivo de origem, exclua o campo da
definio de arquivo de entrada antes de deslocar os campos.
Se um campo de dados tiver sido removido do arquivo fonte, diminua o comprimento
do registro na guia [Opes do arquivo de entrada] aps os campos serem deslocados.
Parmetros
O comando Fieldshift (Deslocar campos) tem os seguintes parmetros: Colunas [Bytes
a deslocar], [Posio] Inicial, OK.
Columns (Colunas)
Especifica o nmero de bytes a serem deslocados para a direita (+) ou esquerda (-).
Start (Inicial)
Especifica a posio inicial do primeiro campo que voc deseja deslocar.
OK
Indica que o comando dever ser executado sem confirmao.
192

Manual de Referncia
Boto Deslocar campos

Para deslocar campos usando o boto Deslocar campos:
1. Selecione Editar a partir da barra de menus e escolha Definio de arquivo de
entrada para exibir a janela de definio de arquivo de entrada.
2. A partir da lista de campos na guia [Editar campos/expresses] selecione o nome
do campo de dados mais esquerda, dentre aqueles campos que voc quer deslocar.
Em seguida clique em
(Deslocar campos) para abrir a caixa de dilogo Deslocar
campos.
Ou voc pode clicar no boto Deslocar campos para abrir a caixa de dilogo
Deslocar campos, em seguida digitar o byte inicial do primeiro campo de dados
que voc quer deslocar na caixa de texto Iniciar o deslocamento dos campos a
partir da posio.
Para exibir campos por ordem de suas posies iniciais da esquerda para direita,
clique no cabealho Iniciar na exibio de lista, na guia [Editar campos/expresses].
Em arquivos com vrios tipos de registros, voc pode deslocar campos relacionados
a um tipo de registro em particular, selecionando primeiro o nome do filtro que
identifica esses campos na lista suspensa na guia [Editar campos/expresses].
3. Informe o nmero de bytes que voc deseja que os campos sejam deslocados na
caixa de texto Deslocar os campos pela seguinte quantidade de bytes. Digite um
nmero positivo para mover os campos para a direita, ou negativo para mover os
campos para a esquerda.
4. Clique em [OK], em seguida clique em [Sim] para confirmar o realinhamento.
Captulo 4
Comandos
Boto Deslocar campos
193
Clique para exibir campos de acordo com suas

posies iniciais, da esquerda para a direita.
Selecione o nome
do filtro para os
campos de um tipo
de registro
especfico.
Digite o byte inicial

do campo a ser
deslocado e o
nmero de bytes a
deslocar, em
seguida, clique em
[OK].

FIELDSHIFT START posio-inicial COLUMNS bytes-a-deslocar
<nome-do-filtro-de-dados> <OK>
posio-inicial especifica a posio do byte do primeiro campo que voc quer
deslocar.
bytes-a-deslocar especifica o nmero de bytes a deslocar.
nome-do-filtro-de-dados especifica o nome do filtro que identifica os campos
relacionados com um tipo de registro em particular.
Exemplo
O comando a seguir desloca o campo iniciando no byte 12 e todos os campos subseqentes 4 bytes direita.
FIELDSHIFT START 12 COLUMNS 4
194

File history (Histrico do arquivo)
Manual de Referncia
File history (Histrico do arquivo)

Use o comando Histrico do arquivo para exibir:
A data, a hora e como o arquivo foi criado
O arquivo de entrada utilizado
Os comandos utilizados
As contagens de registros de entrada e sada
Os totais de controle de entrada e sada (se voc especificar um campo para total
de controle)
Para que haja um histrico, o arquivo precisa ter sido criado por um comando do ACL.
Para definir o nmero mximo de entradas de histrico, use o comando Set History
(Definir histrico). Para obter mais informaes, consulte Set History (Definir
histrico) na pgina 306.
Item de menu Histrico do arquivo

Clique em
(Histrico do arquivo) ou selecione Ferramentas, na barra de menus, e
escolha Histrico do arquivo. Isso emite o comando Exibir histrico. Para obter mais
informaes e a sintaxe do modo de comando, consulte Display (Exibir) na
pgina 165.
Exemplo 1
Por exemplo, se o arquivo A (o arquivo de entrada original) foi ordenado para o arquivo
B que, por sua vez, foi extrado para o arquivo C, o qual foi sumarizado para o arquivo
D, o Histrico do arquivo D mostraria:
Todas as notas relativas ao arquivo A.

O Arquivo A como o arquivo de origem, a data e a hora da ordenao para o
Arquivo B, a sintaxe do modo de comando associada ao comando Ordenar, a
contagem de registros de entrada e sada e totais de controle.
A data e a hora da extrao para o Arquivo C, o Arquivo B como o arquivo de
origem, a sintaxe do modo de comando associada ao comando Extrair, a
A data e a hora da estratificao para o Arquivo D, o Arquivo C como o arquivo
de origem, a sintaxe do modo de comando associada ao comando Estratificar, a
Captulo 4
Comandos
Find (Localizar)
195
O histrico do arquivo exibido na janela de Log de comando. Alm disso, tambm

registrado no arquivo de Log. Se nenhum histrico aparecer na janela de Log de
comando, significa que o arquivo no tem histrico.
Exemplo 2
Para exibir o histrico do arquivo criado no Exemplo 1 na pgina 188, use Histrico
do arquivo.
Na caixa de texto do Log de comando, digite DISPLAY HISTORY.

O histrico do arquivo exibe a data e a hora em que o arquivo Negative_value foi criado
e que ele foi criado por meio da extrao de todos os registros do arquivo de estoque que
apresentavam um valor ou quantidade disponvel negativos.

Consulte Display (Exibir) na pgina 165.
Find (Localizar)
Use o comando Localizar para mover-se diretamente para o primeiro registro contendo
uma chave de pesquisa tipo caractere especificada em um arquivo indexado.
O comando Localizar permite localizar um registro especfico. Voc pode, ento, exibir
ou executar os clculos sobre seu contedo, ou comparar o contedo de um registro
com o de outro.
Se o valor da chave de pesquisa for localizado, o ACL ir posicionar o arquivo naquele
registro. Se o valor no for localizado, o ACL exibir a mensagem Nenhum ndice
corresponde chave, e o arquivo ser posicionado no primeiro registro com um valor
da chave de pesquisa maior que o valor especificado.
Nota: O comando Localizar a opo Localizar literal do comando Pesquisar. Para usar o
comando Pesquisar, selecione Analisar na barra de menus e escolha Pesquisar. Consulte
Search (Pesquisar) na pgina 291 para obter detalhes.
196

Find (Localizar)
Manual de Referncia
Este comando pode ser ativado somente no modo de comando, embora a opo
Pesquisar no menu Analisar tambm fornea acesso ao comando Localizar. Para obter
mais informaes, consulte Emitir comandos na pgina 267 do Guia do Usurio do
ACL para Windows.
Pr-requisitos
O arquivo de entrada deve ser indexado com base em, no mnimo, um campo-chave de
caracteres em ordem crescente. O comando Localizar no opera nas partes dos
campos-chave de ndice que no sejam do tipo caractere ou que estejam em ordem
decrescente.

FIND chave-de-pesquisa-de-caractere
caractere-de-pesquisa-de caractere indica o valor da chave a ser localizada.
A chave-de-pesquisa-de-caractere deve coincidir com o valor a ser localizado. No pode

conter espaos em branco esquerda e no pode ser limitada por aspas. Ela pode ser
menor que a chave de ndice, sendo que, quando isso acontece, o comando Find
(Localizar) compara o valor da chave de ndice somente at o comprimento da chave de
pesquisa e posiciona o arquivo no primeiro registro equivalente ou superior.
A operao de pesquisa no afetada se a preferncia Comparaes exatas de caractere
estiver ativa.
Nota: O comando Localizar faz distino entre maisculas e minsculas.
Exemplo
Para mover-se para o primeiro registro contendo LATEX em um arquivo de estoque que
tenha sido indexado por descrio de produto, use Localizar.
Digite FIND LATEX na caixa de texto do Log de comando.
O ACL exibir o primeiro registro no arquivo cuja descrio de produto contenha a
chave de pesquisa, LATEX.
Captulo 4
Comandos
Gaps (Falhas)
197
Gaps (Falhas)
O comando Falhas uma variao do comando Seqncia e usado para detectar falhas
em campos-chave numricos do arquivo atual.
Voc tambm pode selecionar a caixa de verificao Falhas na caixa de dilogo do
comando Seqncia. Entretanto, a seleo do comando Falhas faz com que o ACL
selecione a caixa Falhas como padro.
Se voc executar o comando Falhas em um campo que tenha caracteres misturados com
nmeros, por exemplo A12345, os caracteres sero ignorados e somente os nmeros
sero testados para verificar a existncia de falhas. Por exemplo, se o campo no prximo
registro for B12346, o ACL no ir relatar a existncia de nenhuma falha, j que A e
B seriam ignorados nos campos.
Para obter mais informaes, consulte Sequence (Seqncia) na pgina 298.
Parmetros
O comando Gaps (Falhas) tem os seguintes parmetros de comando comuns: All
(Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File Type (Tipo de
arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header (Cabealho), If
(Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir), Screen (Tela),
While (Enquanto). Para obter uma descrio, consulte o Captulo 3: Parmetros de
comandos comuns.
Para obter a descrio de outros parmetros, consulte Parmetros na pgina 299.
Caixa de dilogo Falhas

Clique em
(Falhas) ou selecione Analisar, na barra de menus e escolha Falhas para
exibir a caixa de dilogo Falhas.
198

Group (Grupo)
Manual de Referncia
Exemplo
Consulte Exemplo 1 na pgina 301.
Group (Grupo)
Use o comando Grupo em um batch para processar, ao mesmo tempo, um conjunto de
comandos em uma nica passagem pelo arquivo de entrada. Uma vez que os grupos
agregam comandos, de modo que sejam ativados ao mesmo tempo em relao a cada
registro no arquivo de entrada, voc pode reduzir significativamente o tempo de processamento.
Somente comandos baseados em registro e certos comandos de operao de batch so
apropriados para uso no grupo. Esses comandos incluem: Associar, Atribuir, Cancelar,
Classificar, Comentrio, Contar, Duplicidades, Estatsticas, Estratificar, Exportar,
Extrair, Falhas, Fim, Histograma, Listar, Loop, Mesclar, Perfil, Perodo, Relatrio,
Seno, Seqncia, Sumarizar, Total e Verificar.
Os grupos so usados somente em batches. Dentro de cada batch, voc pode incluir um
ou mais grupos simples, condicionais ou aninhados. Antes de criar um grupo, voc deve
estar familiarizado com os conceitos envolvidos na criao de batches. Para obter mais
informaes, consulte Batches na pgina 261 do Guia do Usurio do
ACL para Windows.
Captulo 4
Comandos
Group (Grupo)
199
Parmetros
O comando Group (Grupo) tem os seguintes parmetros: While (Enquanto), First
(Primeiros), Next (Prximo), If (Se) e All (Tudo). Para a descrio desses parmetros,
Caixa de dilogo Grupo

Clique em
(Grupo) em um batch para exibir a caixa de dilogo Grupo.
Exemplo
Para criar um grupo, siga esses passos:
1. Abra um batch. O ACL exibir a janela de batch.
2. Clique em
(Grupo). O ACL exibir a caixa de dilogo Grupo.
3. Se necessrio, digite uma expresso apropriada na caixa de texto Se ou clique em

[Se] para criar uma expresso com o Construtor de expresses. Para obter mais
informaes, consulte Captulo 6: Construir expresses.
4. Se necessrio, clique na guia [Mais] e modifique o escopo.
5. Clique em [OK] para sair da caixa de dilogo Grupo. O ACL exibe a janela de batch
com o comando Grupo.
6. Digite comandos e qualquer condio ou grupos aninhados. Para obter mais informaes, consulte Loop na pgina 232 e Janela batches na pgina 334 do
7. Clique em
(Fim).
8. Feche a janela de batch e salve suas alteraes.
200

Group (Grupo)
Manual de Referncia

Cada comando Group (Grupo) deve ser fechado com um comando End (Fim). Em um
grupo, voc pode especificar os parmetros If (Se) ou While (Enquanto) para testar
uma condio e Else (Seno) para especificar o que acontece aos registros que no
satifazem a condio.
Nota: A indentao de comandos considerada um bom estilo para os grupos. Apesar de
no ser necessrio, esse procedimento ajuda na identificao do incio e fim de um grupo.
GROUP <IF teste> <WHILE teste> <FIRST|NEXT intervalo>
comandos
...
<ELSE> <IF teste>
comandos
...
END
Voc tambm pode incluir um comando Loop em um grupo quando precisar executar
uma srie de comandos mais de uma vez, em relao a informaes repetidas em um
registro em particular. O comando Loop comporta-se similarmente ao comando
Group, exceto pelos comandos entre Loop e End (Fim) serem executados repetidamente, em relao ao registro atual, at que o resultado do teste seja falso. Para obter
mais informaes, consulte Loop na pgina 232.
Grupos simples
O grupos simples iniciam-se com um comando Group (Grupo), so seguidos por uma
srie de comandos e terminam com um comando End (Fim). Por exemplo:
GROUP
COUNT
HISTOGRAM ON QtyOH MINIMUM 0 MAXIMUM 100 INTERVALS 10
CLASSIFY ON Loc ACCUMULATE QtyOH
END
Grupos condicionais
Grupos condicionais executam comandos baseados em uma condio verdadeira ou
falsa. Por exemplo, o comando Group a seguir executado somente em registros com
um campo ProdCls cujo valor menor que 5:
GROUP IF ProdCls < "05"
COUNT
END
Captulo 4
Comandos
Group (Grupo)
201
Os registros que no satisfazem a condio do teste so ignorados, a menos que voc

inclua a instruo Else (Seno). Qualquer nmero de comandos pode seguir uma
instruo Else. No exemplo a seguir, todos os registros que no atendem condio so
processados tendo seus campos QtyOH totalizados.
COUNT
ELSE
TOTAL QtyOH
END
Voc pode incluir instrues Else/If (Seno/Se) mltiplas em um grupo, contanto que
elas contenham um teste diferente. No exemplo a seguir, as instrues Else/If produzem
quatro totais:
COUNT
ELSE IF ProdCls = "05"
TOTAL QtyOH
TOTAL QtyOH
TOTAL QtyOH
ELSE
TOTAL QtyOH
END
ProdCls < 05 ?
Se sim, execute os comandos contar, Histograma e Classificar.
Se no, igual a 05?
Se sim, totalize o campo QtyOH para todos os registros nos quais ProdCls = 05
Se no, igual a 06?
Se sim, totalize o campo QtyOH para todos os registros nos quais ProdCls = 06
Se no, igual a 07?
Se sim, totalize o campo QtyOH para todos os registros nos quais
ProdCls = 07
Se no, totalize o campo QtyOH para todos os registros que no atendam
a nenhum dos testes acima.
202

Group (Grupo)
Manual de Referncia
Grupos aninhados
Grupos aninhados so grupos includos em outros grupos. Os grupos aninhados representam um meio eficiente de controlar quais comandos sero executados para quais
registros. A maioria das aplicaes no necessita de um recurso to avanado, mas esse
recurso est disponvel, se necessrio.
Como em outros grupos, use o comando End (Fim) para encerrar um grupo aninhado.
O ACL iniciar o processamento dos dados somente aps o trmino de todos os
comandos do grupo. Por exemplo:
COUNT
EXTRACT ON QtyOH ACCUMULATE QtyOH MIN 0 MAX 100 INT 10
GROUP IF QtyOH > 0
STATISTICS ON QtyOH
HISTOGRAM ON QtyOH IF ProdStat = "B"
END
ELSE
TOTAL QtyOH
END
Nesse exemplo, todos os comandos de Count (Contar) at o prximo Group (Grupo)

inclusive so executados somente se ProdCls for menor do que 05.
Os comandos Statistics (Estatsticas) e Histogram (Histograma) so executados se
QtyOH for maior do que zero. Entretanto, uma vez que o segundo comando Grupo est
aninhado, os comandos Estatsticas e Histograma so executados somente para
registros que satisfazem as condies ProdCls < "05" e QtyOH > 0.
Alm disso, uma vez que o Histograma tambm tem um teste, executado somente para
registros que satisfazem as condies ProdCls < "05" e QtyOH > 0 e
ProdStat = "B".
Variveis em grupos
O uso de variveis um mtodo eficiente de armazenar informaes de um registro
para utilizar com informaes de registros relacionados posteriormente. As variveis
tambm permitem que os valores sejam acumulados para um conjunto de registros
relacionados.
Por exemplo, imagine que voc tem um arquivo de transaes de contas a receber
ordenado pelo campo CustNo, a partir do qual voc deseja criar um total acumulado
Captulo 4
Comandos
Help (Ajuda)
203
para cada campo de Valor da transao por cliente (Amount) e gravar todas as
transaes com seus totais de execuo em um novo arquivo para anlise posterior.
V_CUSTNO=CustNo
V_AMOUNT=0,00
GROUP IF V_CUSTNO=CustNo
V_AMOUNT=V_AMOUNT+Amount
EXTRACT V_CUSTNO Amount V_AMOUNT TO "TotalsCust.fil"
ELSE
EXTRACT V_CUSTNO Amount V_AMOUNT TO "TotalsCust.fil"
V_AMOUNT=Amount
V_CUSTNO=CustNo
END
Para obter mais informaes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows.
Help (Ajuda)
A ajuda on-line do ACL permite que voc navegue para obter informaes sobre a utilizao do ACL. Ela contm informaes completas sobre comandos, funes, recursos e
tipos de campos.
Boto Ajuda
Selecione Ajuda na barra de menus e escolha Contedo, ou clique em
barra de botes.
(Ajuda) na
Para exibir ajuda sensvel ao contexto, pressione F1 ou clique em [Ajuda] em qualquer

caixa de dilogo do ACL. O ACL apresenta uma janela de Ajuda exibindo as informaes sobre a rea na qual voc est trabalhando.

HELP
Em uma janela de batch, voc pode selecionar o nome de um comando para obter ajuda
sobre o comando selecionado.
As informaes de ajuda no so registradas no arquivo de Log.
Histogram (Histograma)
Use o comando Histograma para produzir um grfico de barras verticais 3D da distribuio de registros sobre valores de um campo ou expresso. Voc pode enviar o
204

Manual de Referncia
resultado para um arquivo, para a tela, ou para uma impressora, ou uma vez que os
dados estejam em formato de grfico possvel especificar outros tipos de grficos. O
histograma til para fornecer uma viso geral do contedo do arquivo. O comando
Histograma trabalha com dados no-ordenados.
Para obter detalhes sobre as opes de sada, consulte Grficos na pgina 229 do
Guia do Usurio do ACL para Windows e Sada para grfico na pgina 263 do
Uma representao horizontal do grfico tambm aparece no Log de comando. Uma
ocorrncia em um determinado intervalo de valores de campo ou expresso representada por um asterisco (*). Cada asterisco pode representar um nmero individual,
parcial ou mltiplo de ocorrncias, conforme necessrio, para ajustar o histograma no
nmero de colunas designado. O Log de comando mostra quantas ocorrncias cada
asterisco representa.
Se escolher o grfico, voc pode cham-lo novamente, clicando duas vezes na sada ou
na instruo <<<Dados de grfico>>> no Log de comando.
O comando Histograma oferece as seguintes opes:
Um histograma de campos numricos com um nmero especificado de intervalos de tamanhos iguais.

Um histograma de campos numricos com intervalos de tamanhos variveis. A
opo Livre permite que voc especifique os tamanhos dos intervalos.
Um histograma de campos no-numricos ou valores de expresso. Uma barra
de histogramas exibida para cada valor exclusivo do campo ou expresso. Esses
valores so exibidos em seqncia crescente de ordenao.
Voc pode executar este comando de forma automtica.

Para isso, consulte Opes de comando na pgina 319 do Guia do Usurio do
ACL para Windows.
Parmetros
Alm dos parmetros descritos abaixo, o comando Histogram (Histograma) tem os
Next (Prximo), Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), While
(Enquanto). Para a descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Captulo 4
Comandos
205
Columns (Colunas)
Permite que voc especifique o nmero de colunas que deseja para a representao
horizontal do grfico do histograma no Log de comando. Todas as contagens de
intervalo tm a escala ajustada de acordo com o espao disponvel. O padro 78.
Free (Livre)
Especifica pontos iniciais e finais.
Para um histograma numrico, permite especificar o ponto inicial de cada intervalo e o
ponto final do ltimo intervalo. Digite o ponto inicial de cada intervalo na caixa de texto
Livre, um valor por linha. O ltimo nmero digitado interpretado como o ponto final
do intervalo final.
Histogram On (Histograma em)

Permite que voc especifique o campo ou expresso para a qual voc deseja desenvolver
um histograma. Voc pode usar tipos de campos numricos ou de caracteres. Selecione
um campo em uma lista suspensa Histograma em, ou clique em [Histograma em] para
exibir a caixa de dilogo Campos selecionados. Para obter mais informaes, consulte
Exibir lista na pgina 42 do Guia do Usurio do ACL para Windows.
Intervals (Intervalos)
Aplica-se somente a campos numricos. Permite que voc especifique o nmero de
intervalos uniformes que o ACL produz entre o valor mnimo e o mximo.
O padro 10, mas voc pode alterar esse padro na caixa de dilogo Editar preferncias
do ACL.
Para alterar as preferncias da opo de comando, consulte Opes de comando na
Maximum (Mximo)
Aplica-se somente a campos numricos e permite que voc especifique o valor mximo
do ltimo intervalo. Se voc emitiu um comando Perfil ou Estatsticas, o padro o
valor mais alto no campo numrico. Do contrrio, no h padro.
Minimum (Mnimo)
Aplica-se somente a campos numricos e permite a especificao do valor mnimo do
primeiro intervalo. Se voc emitiu um comando Perfil ou Estatsticas, o padro o valor
mais baixo no campo numrico. Do contrrio, no h padro.
206

Manual de Referncia
Caixa de dilogo Histograma

Clique em
(Histograma) ou selecione Analisar na barra de menu e escolha Histograma para exibir a caixa de dilogo Histograma.
Exemplo 1
Voc pode produzir um histograma para mostrar a distribuio do crdito do cliente,
fornecendo informaes que podem ser usadas no ajuste da poltica de crdito.
Para criar um histograma de intervalos uniformemente espaados:
1. Selecione o campo denominado Limite (Limit), na lista suspensa, ou clique em
[Histograma em] para exibir a caixa de dilogo Campos selecionados, a fim de
obter mais informaes detalhadas sobre os campos nesse arquivo. Aps selecionar
um campo, clique em [OK] para retornar caixa de dilogo Histograma.
Campo Selecionado
Especifque mnimo
e mximo
2. Especifique o mnimo de 5000 e o mximo de 50.000, e aceite o padro de 10 intervalos.
Captulo 4
Comandos
207
3. Clique em [OK] para executar o comando e exibir o grfico. O grfico mostra que o
valor mais alto de crdito situa-se no intervalo 50.000.
O ACL tambm produz uma representao do grfico baseada em caracteres no Log

de comando. Voc pode acessar o grfico clicando duas vezes em <<<Dados do
grfico>>> ou em qualquer lugar do texto dos resultados do histograma no Log
de comando.
208

Manual de Referncia
Exemplo 2
O histograma obtido no exemplo 1 mostra que a maior parte do crdito permaneceu no
intervalo de 50.000. Voc pode obter uma quebra posterior dessa distribuio criando
um histograma de intervalos livres.
Para criar um histograma de intervalos livres:
1. Selecione o campo denominado Limite (Limit), na lista suspensa Histograma em.
Especifique um mnimo de 50.000, um mximo de 300.000 e intervalos livres de
50.000, 75.000, 100.000 e 300.000.
2. Clique em [OK] para executar o comando e exibir o grfico. Ele mostra que a
maioria dos limites de crdito situa-se no intervalo entre 50.000 e 75.000 e que
nenhum crdito estendeu-se alm de 100.000.
Captulo 4
Comandos
209
O Log de comando mostra 33 ocorrncias de crdito no intervalo entre 50.000 e 75.000.

HISTOGRAM <ON> nome-do-campo-numrico <INTERVALS=n>
MAXIMUM=mx
MINIMUM=mn
HISTOGRAM <ON> nome-do-campo-numrico FREE
Pontos-iniciais-do-intervalo
Ponto-final-do-intervalo
HISTOGRAM <ON> nome-do-campo-de-caractere
Voc pode acrescentar as seguintes opes para cada formato de sintaxe:

<TO nome-de-arquivo-a-ser-criado|SCREEN|GRAPH|PRINT>
<IF teste> <WHILE teste>
<FIRST|NEXT intervalo>
<HEADER cabealho>
<FOOTER rodap>
<KEY campo-de-quebra <+....>>
<SUPPRESS>
<COLUMNS=n>
<APPEND>
210

If (Se)
Manual de Referncia
If (Se)
O comando Se permite especificar uma condio que deve ser atendida para que o
comando que se segue seja executado. A condio se aplica a todo o comando e deve ser
atendida para que o comando continue o processamento.
O comando Se avalia o teste quando o ACL encontra pela primeira vez o comando. Se o
teste resultar em verdadeiro, o comando que se segue ser processado. Se o teste resultar
em falso, o ACL ir ignorar o resto do comando.
Isso difere da condio Se no nvel do comando que testa cada registro do arquivo e
executa o comando nos registros que atendem s condies do teste.
Em um batch, voc pode digitar uma srie de testes de comando Se e executar diversos
comandos com base no resultado. O comando Se mais til para testar uma varivel a
fim de determinar se o arquivo ser processado.
Qualquer comando do ACL vlido pode acompanhar o teste.
Este comando s pode ser executado no modo de comandos e til apenas em batches.

IF teste COMANDO
Exemplos
Para executar uma amostra, mas somente se a varivel Count1 for maior que dez:
IF Count1 > 10 SAMPLE Amount...
Suponha que voc tenha emitido previamente um comando Dilogo, com um controle
de caixa de verificao que cria a varivel StartCheckBox (que o usurio pode marcar
para exibir as estatsticas). Voc poderia usar o seguinte comando para produzir as
estatsticas, se solicitado:
IF StatCheckBox STATISTICS ALL
Import (Importar)
Use esse comando para importar dados de uma origem externa para o
ACL para Windows. O comando Import permite importar arquivos em lotes e, em
seguida, realizar outras anlises nesses arquivos, sempre de dentro dos lotes.
Se um arquivo de origem exigir uma senha, use o comando Password para solicit-la ao
usurio a fim de que o comando Import possa ser executado. Consulte Password
(Senha) na pgina 243 para obter detalhes.
Captulo 4
Comandos
Index (ndice)
211
A maneira mais fcil de criar o comando Import consiste em importar usando o Assistente de Definio de Dados e, em seguida, copiar o comando Import do log de
comando e col-lo no lote.
Nota: S necessrio importar dados externos uma vez. Depois disso, voc pode usar o
comando Refresh para atualizar os dados da origem. Consulte Refresh (Atualizar) na
pgina 252 para obter detalhes.
Importando dados externos

Para obter informaes sobre as opes disponveis para importao de dados, consulte
Captulo 3: Definir arquivos e campos no Guia do Usurio do ACL para Windows
Verso 7.

IMPORT {ODBC|SAP|PRINT} <TO nome-ifd> <PASSWORD n>
dados-especficos-da-origem
Index (ndice)
Use ndice como um pr-requisito para acessar um arquivo, usando Definir relacionamentos, no modo de comando ou o comando Relacionamentos, na barra de menus.
Alm disso, use o comando ndice para criar um arquivo de ndice que permita acesso
direto aos registros de um arquivo de entrada em uma ordem lgica, ao invs de fsica.
Voc pode ter mais que um arquivo de ndice relacionado a um determinado arquivo de
entrada. Somente um arquivo de ndice pode estar ativo de cada vez.
Antes de usar os arquivos de ndice, consulte Janela Viso geral na pgina 29 do
Guia do Usurio do ACL para Windows e ndice na pgina 101 do Guia do Usurio do
ACL para Windows.
Alguns comandos, como o Definir relacionamentos, exigem que voc indexe os
arquivos relacionados antes de definir os relacionamentos. Para obter mais informaes,
consulte tambm Relations (Relacionamentos) na pgina 253 e Operaes com
vrios arquivos na pgina 103 do Guia do Usurio do ACL para Windows.
Nota: No ser necessrio usar ndice ou Ordenar com Classificar, Perodo, Histograma e
Estratificar, j que esses comandos no exigem um arquivo ordenado.
212

Index (ndice)
Manual de Referncia
Indexao versus Ordenao

O comando ndice uma alternativa ao comando Ordenar, normalmente mais rpida, e
o arquivo de ndice resultante geralmente bem menor. Entretanto, o processamento
em um arquivo indexado de forma seqencial significativamente mais lento do que em
um arquivo ordenado.
A tabela a seguir compara as vantagens e desvantagens dos comandos Ordenar e ndice.
Ordenao
Indexao
Velocidade de execuo
Mais lenta
Mais rpida
Tamanho do arquivo resultante
Maior
Menor
Espao em disco necessrio
Mais
Menos
Processamento subseqente de um arquivo

completo
Mais rpido
Mais lento
Processamento subseqente pesquisando poucos

registros
Mais lento
Mais rpido
Use o comando ndice como uma alternativa ao comando Ordenar, somente quando o
espao no disco for muito limitado ou se voc quiser localizar registros rapidamente
com um valor de chave especfico.
Nota: Se pretende acessar mais que 10% dos registros do arquivo, prefervel ordenar os
dados para otimizar a velocidade de processamento.
O comando ndice cria um arquivo de ndice contendo ponteiros para os registros no
arquivo de entrada aberto. Esses ponteiros so organizados de modo que o arquivo de
entrada possa ser acessado em uma ordem lgica. Por exemplo, ativando a opo
Localizar literal do comando Pesquisar, voc pode localizar registros com valores de
chave especficos muito rapidamente (geralmente em menos de 1 segundo).
Seqncia de ordenao
A chave de ordenao do arquivo de ndice pode conter quantos campos voc quiser at
um comprimento de chave mximo de 255, e cada campo pode estar em ordem
crescente ou decrescente, independentemente dos outros. Os registros so ordenados
com base nos valores de campo, na ordem em que os campos so selecionados. O
primeiro campo selecionado a primeira chave de ordenao, e assim por diante.
As opes Localizar literal e Buscar expresso do comando Pesquisar operam somente
em campos-chave de ndice que sejam do tipo caractere e estejam em ordem crescente.
Voc pode incluir campos no-caractere ou campos decrescentes em um arquivo
Captulo 4
Comandos
Index (ndice)
213
indexado, e ainda usar os comandos Localizar ou Encontrar. Entretanto, estes

comandos somente iro operar corretamente se os primeiros campos-chave estiverem
em ordem ascendente de caracteres.
Para obter mais informaes sobre como mover-se diretamente para registros especficos em um arquivo, consulte Search (Pesquisar) na pgina 291.
Ativar ndices
H duas maneiras de ativar um arquivo de ndice. Ao criar o ndice pela primeira vez,
certifique-se de que a caixa de seleo Usar arquivo de sada esteja assinalada na caixa de
dilogo ndice. Isso ativa o ndice, quando o comando ndice executado. Para ativar
um ndice previamente criado, clique duas vezes no ndice na janela Viso geral.
Quando o ndice estiver ativado, a palavra Indexado aparecer ao lado da contagem de
registros, na barra de status.
Para verificar se um ndice est ativo, olhe para o meio da barra de status. A janela
indicar x Registros Indexados ou x ndice filtrado, dependendo se o ndice foi ou
no criado com o uso de um filtro.
Dicas de indexao
A seguir, so apresentadas algumas dicas para trabalhar com ndices:
Fornea ao ndice um nome que faa referncia a alguns detalhes importantes

sobre ele, tais como, o arquivo de dados de entrada para o qual o ndice foi
criado, os campos-chave, etc.
Quando voc clica em [ndice], na caixa de dilogo Selecionar definio de
arquivo de entrada, o ACL exibe todos os ndices que foram criados para todos
os arquivos de entrada. Se voc selecionar um ndice que no seja apropriado
para um arquivo de entrada, o ACL ir identificar o arquivo de entrada para o
qual o ndice foi criado. A melhor maneira de selecionar o ndice correto
escolhendo-o diretamente da janela Viso geral.
A maneira mais rpida de saber qual ndice est sendo usado no momento
consiste em procurar um cone colorido, na seo ndices da janela Viso geral.
Filtros e condies
Se voc cria um ndice usando um filtro, o ACL exibe ndice filtrado na barra de
status, para inform-lo de que voc s est consultando a parte do arquivo correspondente condio do filtro.
214

Index (ndice)
Manual de Referncia
Um ndice condicional elimina os registros que no atendem a uma condio especificada. Isso permite que voc crie arquivos de ndice separados para subconjuntos de
um arquivo maior, para manipulao posterior. No inclua uma condio se quiser que
o arquivo inteiro seja indexado.
Alm do teste Se, voc pode selecionar a caixa de dilogo [Mais] e especificar os
parmetros Enquanto, Prximo e Primeiros. Somente os registros do arquivo de
entrada aberto que atenderem condio especificada tero ponteiros no arquivo de
ndice resultante. Se o processamento for finalizado antes por um desses parmetros, os
registros subseqentes no sero includos no arquivo de ndice e no podero ser
acessados quando o arquivo for usado. Nem sempre ser bvio que voc no est trabalhando com o arquivo inteiro. Para assegurar-se de estar trabalhando com um arquivo
indexado, procure a palavra ndice filtrado na barra de status. Somente os registros
que tiverem atendido a condio sero processados pelos comandos executados,
enquanto o ndice estiver ativo.
Parmetros
Alm do parmetro descrito abaixo, o comando Index (ndice) tem os seguintes
parmetros: All (Tudo), Ascending (Crescente), Descending (Decrescente), File
(Arquivo), First (Primeiros), If (Se), Local (Local), Next (Prximo), To (Para), While
(Enquanto). Para a descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Index On (Indexar em)

Especifica as expresses ou campos-chave do arquivo de entrada, a serem indexados.
Selecione os campos da caixa de listagem ou clique em [Indexar em] para abrir a caixa
de dilogo Campos selecionados. Para obter mais informaes, consulte Caixas de
dilogo selecionar/editar na pgina 40 do Guia do Usurio do ACL para Windows.
Caixa de dilogo ndice

Clique em
(ndice) ou selecione Dados, na barra de menus e escolha ndice para
exibir a caixa de dilogo ndice.
Captulo 4
Comandos
Index (ndice)
215
Criar um ndice
Para criar um novo ndice:
1. Clique em
(ndice) na barra de botes ou selecione Dados na barra de menus e
escolha ndice para exibir a caixa de dilogo ndice.
2. Na caixa de dilogo ndice, selecione um campo na caixa de listagem Indexar em.
Voc pode tambm clicar em [Indexar em]para exibir a caixa de listagem Campos
selecionados, que fornece mais informaes sobre os campos que voc est selecionando.
216

Index (ndice)
Manual de Referncia
H trs maneiras de selecionar campos usando a caixa de dilogo Campos selecionados:
Clique no nome do campo para selecion-lo, em seguida na

para mov-la entre as caixas de listas.
(seta)
Clique duas vezes no nome do campo para selecion-lo e mov-lo da caixa de

listagem Campos disponveis para a caixa de listagem Campos selecionados.
Clique em [Expr] para exibir o Construtor de expresses. O Construtor de
expresses permite que voc aplique uma condio ou filtro a um dado no
campo selecionado.
Selecione o campo que voc deseja na caixa de listagem Campos disponveis e, em

seguida, clique em [OK] para retornar caixa de dilogo ndice.
3. Digite um nome para o ndice na caixa de texto Para.
4. Clique em [OK] para fechar a caixa de dilogo e executar o comando ndice. O ACL
lista o ndice na janela Viso geral sob a definio de arquivo de entrada associada e
sob os ndices.
Exemplo
Para colocar um arquivo de cliente em ordem alfabtica para facilitar a consulta, use
ndice.
Indexar sobre o campo nome do cliente no arquivo de ndice, Customer_name.
Captulo 4
Comandos
Index (ndice)
Antes da indexao, o arquivo do cliente tem este contedo.
Depois da indexao, o arquivo ter este contedo:
217
218

Join (Associar)
Manual de Referncia
Agora voc pode usar as opes do comando Pesquisar para acessar registros individuais rapidamente. Use a barra de rolagem para visualizar o arquivo inteiro. Observe
que o primeiro registro do arquivo indexado 1st Technology Group. Em um arquivo
indexado, os nmeros so listados antes dos caracteres alfabticos.

INDEX <ON> campo-chave <D>... TO
nome-do-arquivo-a-ser-criado
<OPEN>
Join (Associar)
Use o comando Associar para combinar campos a partir de dois arquivos de entrada
ordenados, formando um terceiro arquivo.
Associar geralmente usado para combinar registros em um arquivo de transao com
aqueles em um arquivo de cadastro. Voc pode, por exemplo, combinar dados de uma
fatura em um arquivo de contas a receber, com dados em um arquivo de cliente, ou
comparar o contedo de dois arquivos.
Ao associar um arquivo de transao e um arquivo mestre, o arquivo de transao ,
geralmente, o arquivo primrio e o arquivo mestre o arquivo secundrio. Identifique
com cuidado seus arquivos primrio e secundrio, uma vez que os resultados diferem se
a ordem dos arquivos for invertida.
Associar versus Relacionamentos

Associar e Relacionamentos permitem que voc trabalhe com dados de mais de um
arquivo. Associar fornece diversas opes de incluso/excluso que no esto disponveis por meio do comando Relacionamentos. Entretanto, certos tipos de anlise so
realizados mais facilmente com os Relacionamentos. Dependendo do tipo de anlise
exigida, um comando pode ser mais eficiente que outro.
Associar permite combinar dados de dois arquivos diferentes, com a sada indo para um
terceiro arquivo contendo os dados correspondentes ou no-correspondentes, dependendo do tipo de associao que voc especificou.
Relacionamentos permite que voc crie associaes virtuais entre arquivos. Dados de
arquivos separados, porm relacionados, podem ser analisados como se existissem em
um nico arquivo.
Em ambos os casos, voc precisa de um campo-chave comum aos dois arquivos a serem
associados ou relacionados.
Captulo 4
Comandos
Join (Associar)
219
Associar usa mais espao em disco que Relacionamentos, por trs razes:
Para uma associao, voc deve ordenar o arquivo secundrio e, de preferncia,

ordenar ou indexar tambm o arquivo primrio. Porm, para relacionar dois
arquivos, voc precisa indexar somente um deles. A ordenao cria um novo
arquivo de dados, do tamanho do original. A indexao cria um pequeno
arquivo de ndice, que aponta para o arquivo original.
Associar cria um novo arquivo que pode ser maior que ambos os arquivos
primrio e secundrio juntos, dependendo do tipo de associao executada.
Relacionamentos no grava um novo arquivo. Se voc precisar de um arquivo
que contenha os dados relacionados, pode criar um arquivo extraindo os
campos relacionados e usando o comando Extrair.
Para associar quatro arquivos, voc precisa executar trs ordenaes e trs
associaes. Para relacionar quatro arquivos, voc precisa do arquivo original e
trs ndices dos arquivos restantes.
Opes de sada da associao

O comando Associar tem cinco opes de sada, baseadas em comparaes de
campo-chave. A opo de sada escolhida determina quais registros sero includos no
arquivo de sada. A tabela a seguir ilustra quais registros esto includos no arquivo de
sada para cada opo:
Opo
Primrio
Secundrio
Primrio No- Secundrio No
correspondente correspondente correspondente -correspondente
Registros
correspondentes
Registros
correspondentes:
todos primrios
Registros
correspondentes:
todos secundrios
Registros
correspondentes:
todos primrios e
todos secundrios
Registros nocorrespondentes
220

Join (Associar)
Manual de Referncia
Registros correspondentes
Cria um arquivo de sada com os campos selecionados dos arquivos primrio e secundrio, para todos os registros do arquivo primrio com correspondncias de
campo-chave no arquivo secundrio.
Se houver mais de um campo-chave correspondente no arquivo secundrio, o ACL usa
o primeiro registro correspondente que encontrar. Se nenhum registro correspondente
for encontrado, nenhum registro de sada ser produzido.
Registros correspondentes: todos primrios

Cria um arquivo de sada com os campos selecionados dos arquivos primrio e secundrio para todos os registros no arquivo primrio, incluindo aqueles sem correspondncia no arquivo secundrio. Os campos para aqueles registros sem nenhuma
correspondncia no arquivo secundrio so preenchidos com espaos em branco ou
zeros, dependendo do tipo de campo.
Todos os registros no-correspondentes do arquivo secundrio so ignorados.
Registros correspondentes: todos secundrios

Cria um arquivo de sada com os campos selecionados dos arquivos primrio e secundrio, para todos os registros do arquivo secundrio, incluindo aqueles sem correspondncia no arquivo primrio. Os campos para aqueles registros sem correspondncia no
arquivo primrio so preenchidos com espaos em branco ou zeros, dependendo do
tipo de campo.
Todos os registros no correspondentes do arquivo primrio so ignorados.
Registros correspondentes: todos primrios e todos secundrios

Cria um arquivo de sada dos campos selecionados para todos os registros de ambos os
arquivos, primrio e secundrio, no importando se os registros tenham ou no corespondncia. Os campos para os registros no-correspondentes de qualquer arquivo e
duplicidades do arquivo secundrio so preenchidos com espaos em branco ou nulos,
dependendo do tipo de campo.
Registros no-correspondentes
Cria um arquivo de sada com todos os registros do arquivo primrio que no tenham
correspondncias no arquivo secundrio. O arquivo de sada s inclui campos
primrios porque no existem informaes secundrias quando os registros no tm
correspondncia.
Captulo 4
Comandos
Join (Associar)
221
Outras opes
Para identificar transaes para as quais no existe nenhum registro de cadastro, especifique o arquivo de transao como um arquivo primrio. Para identificar registros do
cadastro sem nenhuma transao correspondente, especifique o arquivo de cadastro e
como arquivo primrio.
Opo IMS um para muitos

Os usurios com conexo cliente/servidor para um banco de dados IMS podem
tambm executar associaes que incluem um conjunto de dados IMS como arquivo
secundrio. Selecione essa opo para executar uma associao do tipo um para muitos,
com um conjunto de dados IMS como o arquivo secundrio.
Nota: O ACL fornece uma mensagem de erro para o Log de comando, se o arquivo secundrio IMS no for HDAM.
Nomes dos campos do arquivo de sada

Se quaisquer campos dos arquivos primrio e secundrio tiverem o mesmo nome, o
comando Associar ir atribuir, automaticamente, um novo nome para o campo secundrio no arquivo de sada. Por exemplo, se ambos os arquivos contiverem um campo
chamado Amount, Associar tenta nomear o campo secundrio Amount2,
Amount3, e assim por diante, at que encontre um nome que no conflite com
nenhum nome de campo no arquivo de sada.
Localizao dos arquivos de origem

Ambos os arquivos que voc associar devem pertencer ao mesmo projeto ACL. Da
mesma maneira, em um ambiente cliente/servidor, voc pode conectar-se somente a
um servidor de cada vez, de modo que os arquivos associados devem residir no mesmo
servidor. Conseqentemente, no se pode associar um arquivo cliente a um arquivo
servidor.
Preparando os campos-chave
possvel selecionar mais de um campo-chave. Voc pode fazer isso, por exemplo, se
tiver um fornecedor com o mesmo nmero, em locais diferentes. Para capturar todos os
registros para esse fornecedor, no importando a localizao, voc pode selecionar os
campos de localizao e de fornecedor como campos-chave. Voc teria, ento, que
selecionar dois campos-chave correspondentes no arquivo secundrio tambm.
Antes de usar Associar, voc deve ordenar o arquivo secundrio em ordem crescente
pelos campos-chave alfanumricos. Embora no obrigatrio, tambm recomendvel
que voc ordene o arquivo primrio pelos campos-chave. Voc pode fazer isso selecionando a caixa de verificao Pr-ordenar, na caixa de dilogo Associar. Tambm
possvel indexar o arquivo primrio em vez de orden-lo.
222

Join (Associar)
Manual de Referncia
Voc pode usar Associar com um arquivo primrio no-ordenado, mas, para associaes muito grandes, o tempo de processamento aumenta dramaticamente. Se o
arquivo primrio estiver parcialmente ordenado pelo campo-chave, como acontece
quando um campo ordenado por cdigo de conta por meses individuais, o tempo de
processamento aumenta, mas no muito.
Os campos-chave devem ser campos de caracteres. Seu comprimento deve ser o mesmo
nos arquivos primrio e secundrio. Se os campos no forem idnticos, voc pode usar
vrias funes do ACL, como STRING( ), DATE( ) e SUBSTRING( ), para converter
campos de um tipo de dados em outro e para modificar suas estruturas, tornando-as
adequadas para o uso como campos-chave.
Para converter campos numricos no formato de caractere, consulte STRING( ) na
pgina 80. Consulte tambm Construtor de expresses na pgina 275 do
Guia do Usurio do ACL para Windows e Captulo 2: Funes para obter mais informaes sobre outras alteraes que queira fazer.
Parmetros
Alm dos parmetros descritos abaixo, o comando Join (Associar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros), If
(Se), Local (Local), Next (Prximo), To (Para), Use Output File (Usar arquivo de sada),
While (Enquanto). Para uma descrio desses parmetros, consulte o Captulo 3:
IMS One to Many (IMS um para muitos)

Inclui os registros de um arquivo IMS no arquivo de sada. Esta opo s permitida se
o arquivo secundrio for do IMS.
Matched Records (Registros correspondentes)

Inclui registros correspondentes de um arquivo primrio e registros correspondentes do
arquivo secundrio, no arquivo de sada. a opo padro.
Matched Records: All Primary (Registros correspondentes: todos primrios)

Inclui registros correspondentes dos arquivos primrio e secundrio e registros
no-correspondentes do arquivo primrio no arquivo de sada.
Matched Records: All Seconary (Registros correspondentes: todos secundrios)

Inclui registros correspondentes dos arquivos primrio e secundrio e registros
no-correspondentes do arquivo secundrio no arquivo de sada.
Captulo 4
Comandos
Join (Associar)
223
Matched Records: All Primary and All Secondary (Registros correspondentes: todos primrios e
todos secundrios)
Inclui todos os registros dos arquivos primrio e secundrio no arquivo de sada.
Presort (Pr-ordenar)
Ordena o arquivo primrio pelas chaves primrias, antes de associar os arquivos. A
pr-ordenao no pode ser usada em um grupo.
Primary Fields (Campos primrios)

Especifica quais campos ou expresses do arquivo primrio incluir no arquivo de sada.
Selecione os campos na exibio de lista ou clique em [Campos primrios] para exibir a
caixa de dilogo Campos selecionados.
Os campos-chave no so includos automaticamente na sada, portanto voc deve
selecion-los, se necessrio.
Primary Keys (Chaves primrias)

Especifica quais campos ou expresses-chave de um arquivo primrio devem ser
includos. Selecione os campos-chave na exibio de lista ou clique em [Chaves
primrias] para abrir a caixa de dilogo Campos selecionados.
Secondary Fields (Campos secundrios)

Especifica quais campos secundrios incluir no arquivo de sada. Selecione os campos
na exibio de lista ou clique em [Campos secundrios] para exibir a caixa de dilogo
Campos selecionados.
Os campos-chave no so includos automaticamente na sada, portanto necessrio
selecion-los, se for necessrio. Para obter mais informaes, consulte Caixas de
Secondary File (Arquivo secundrio)

Permite que voc escolha o arquivo secundrio que deseja associar ao arquivo primrio.
Selecione o arquivo da lista suspensa.
Secondary Keys (Chaves secundrias)

Permite que voc selecione campos ou expresses chave do arquivo secundrio.
Selecione os campos-chave da exibio de lista ou clique em [Chaves secundrias] para
abrir a caixa de dilogo Campos selecionados.
Unmatched Records (Registros no-corresp.)

Inclui somente registros no-correspondentes do arquivo primrio no arquivo de sada.
224

Join (Associar)
Manual de Referncia
Caixa de dilogo Associar

Clique em
(Associar) ou selecione Dados, na barra de menus e escolha Associar
para exibir a caixa de dilogo Associar.
Exemplo 1
Esse exemplo mostra como associar registros correspondentes de um arquivo de contas
a receber e um arquivo de cadastro de clientes, usando a opo Todos primrios. A
combinao das informaes de ambos os arquivos fornece uma base melhor para as
anlises de transaes e preparao de cartas de confirmao.
O arquivo primrio o arquivo do contas a receber. O arquivo secundrio o arquivo de
cadastro de clientes. O arquivo de sada associado chamado de Join_ar_customer.
Antes de associar os arquivos, ordene-os por nmero de cliente, nomeando-os
Ar_sort e Customer_sort, respectivamente.
Para associar Ar_sort e Customer_sort:
1. Primeiro exiba a caixa de dilogo Associar. Para faz-lo, abra o arquivo primrio
Ar_sort e selecione Dados na barra de menus e escolha Associar.
2. Em seguida, selecione o arquivo secundrio Customer_sort na lista suspensa
Arquivo secundrio.
Captulo 4
Comandos
Join (Associar)
225
3. Selecione o campo-chave primrio, No, clicando sobre o mesmo na lista [Chaves

primrias].
4. Selecione os campos do arquivo primrio a incluir no arquivo de sada. Clique em
[Campos primrios] para exibir a caixa de dilogo Campos selecionados. Em
seguida, selecione esses campos nessa ordem: cdigo do cliente (No), data da fatura
(Date), data de vencimento (Due), nmero da fatura (Ref), tipo da transao (Type)
e valor da transao (Amount).
A ordem na qual voc seleciona os campos a ordem na qual aparecem na exibio
do arquivo associado. Clique em [OK] para voltar caixa de dilogo Associar.
5. Selecione o campo-chave secundrio No, clicando na lista de exibio [Chaves
secundrias].
6. Selecione os campos do arquivo secundrio para incluir no arquivo de sada. Clique
em [Campos secundrios] para exibir a caixa de dilogo Campos selecionados. Em
seguida, selecione os campos Name e State. Clique em [OK] para voltar caixa
de dilogo Associar.
7. Nomeie o arquivo digitando Join_ar_customer na caixa de texto Para.
8. Para incluir todos os registros do arquivo primrio, no importando se tm correspondncia no arquivo secundrio, clique na guia [Mais] e selecione Todos
primrios.
226

Join (Associar)
Manual de Referncia
9. Clique em [OK] para executar o comando e exibir o arquivo de sada

Join_ar_customer. Os campos do arquivo secundrio, Name e State esto localizados direita da exibio. O arquivo associado deve ter o mesmo nmero de
registros do arquivo primrio, j que voc selecionou Todos primrios.
Exemplo 2
Este exemplo mostra como procurar por registros no-correspondentes usando os
mesmos arquivos primrio e secundrio, campos-chave, e campos primrios e secundrios, como no Exemplo 1. Registros no-correspondentes significam erros em
potencial nos arquivos.
Siga o Exemplo 1, mas dessa vez nomeie o arquivo Join_ar_customer_no_matches e na
guia [Mais] selecione Registros no-corresp.
Clique em [OK] para executar esse comando e exibir o arquivo de sada. Como no h
correspondente no arquivo do cliente para o cliente nmero 535189, os campos de
nome do cliente e estado no aparecem no arquivo associado. A ausncia de correspondncia para esse nmero de registro pode demandar uma investigao futura.
Captulo 4
Comandos
List (Listar)
227

H cinco variaes de Join (Associar) no modo de comando:
JOIN
JOIN {PRIMARY|BOTH}
JOIN SECONDARY
JOIN PRIMARY SECONDARY
JOIN UNMATCHED
Voc tambm pode adicionar qualquer uma dessas opes ao formato da sintaxe:
<FIELDS> lista-de-campos-primrios
<PRESORT>
WITH lista-de-campos-secundrios
TO criar-nome-de-arquivo
PKEY lista-de-campos-chave-primrios
SKEY lista-de-campos-chave-secundrios
<OPEN>
<APPEND>
<MANY>
MANY permite que voc execute uma associao um-para-muitos quando existe uma
conexo cliente/servidor e seu arquivo secundrio um banco de dados IMS.
List (Listar)
Use o comando Listar para exibir dados de sada selecionados em formato de lista por
coluna. Por exemplo, voc pode usar Listar para analisar o contedo detalhado de um
arquivo de entrada.
Este comando s pode ser executado no modo comando. Para obter mais informaes,
consulte Grupos na pgina 340 do Guia do Usurio do ACL para Windows.
Este comando permite que voc selecione informaes do arquivo de entrada e
apresente na tela, envie diretamente para a impressora ou salve em um arquivo de texto.
A menos que seja especificado de outra forma, a sada enviada somente para a tela.
Voc pode incluir o parmetro Linha opcional para criar listagens de vrias linhas.
Os nmeros de pgina, data, hora, identificao do usurio e os ttulos de coluna so
fornecidos automaticamente. As colunas numricas tambm so totalizadas automaticamente. Voc pode especificar o uso de vrias linhas, bem como cabealhos e rodaps
centralizados por meio dos parmetros Cabealho e Rodap.
228

List (Listar)
Manual de Referncia
Como os ttulos de coluna so determinados pela primeira linha de campos, certifique-se de especificar os cabealhos apropriados na primeira linha. Use o modificador
Width apropriado para controlar o posicionamento horizontal em cada linha e garantir
que os campos estejam alinhados verticalmente como deseja.
Nota: A organizao de uma Exibio uma forma mais poderosa de listar e analisar
dados do arquivo de entrada.
Consulte Apresentar uma exibio na pgina 196 do Guia do Usurio do
Parmetros
Alm dos parmetros descritos abaixo, o comando List (Listar) tem os seguintes
parmetros: All (Tudo), End Of File (Fim do Arquivo), Footer (Rodap), Header
(Cabealho), To (Para). Para a descrio desses parmetros, consulte o Captulo 3:
Fields (Campos)
Indica que os campos que sucedem esta palavra-chave devem ser includos na linha um
da lista.
Line (Linha)
Especifica linhas adicionais de sada.
Para relatrios de linhas mltiplas, os ttulos de coluna so determinados pela linha 1.
Os cabealhos para outras linhas no sero enviados para a sada. Se necessrio, ajuste
os cabealhos na linha 1, de modo a refletir as informaes nas outras linhas.
Skip (Ignorar)
Faz com que o ACL insira o nmero especificado de linhas em branco entre cada
registro da lista. Por exemplo, LIST ALL SKIP 1 produz uma lista com espaamento
duplo (uma linha em branco entre cada registro).
Nota: Ao criar um relatrio de vrias linhas, voc pode usar modificadores de campo, tais
como Largura e Como, para alinhar colunas e ajustar cabealhos.
Consulte Modificadores de campo na pgina 261 do Guia do Usurio do
Captulo 4
Comandos
List (Listar)
229
Unformatted (Sem formatao)

Suprime os recursos especiais de paginao de lista e o espao entre os campos (formato
SDF no delimitado). Cria a sada idntica criada pelo comando Exportar ASCII.
Utilize-o com a opo TO nome-de-arquivo para produzir uma sada que possa ser
posteriormente processada por outro software.

LIST {<FIELDS>listar_campos|ALL} <PARA nome-do-arquivo>
LINE n campos-da-listagem
<UNFORMATTED>
<HEADER cabealho>
<FOOTER rodap>
<SKIP n>
<EOF>
<APPEND>
campos-da-listagem especifica os campos a serem listados. Qualquer campo ou
expresso pode ser utilizado(a). Digite All para listar todos os campos definidos.
Quando usado com o parmetro LINE, campos-da-listagem especifica os campos ou
expresses a serem listados naquela linha.
LINE n pode ser um valor entre 2 e 60.
Exemplo
Este exemplo lista os campos selecionados para os registros que satisfazem a uma
condio especificada.
Voc pode usar o comando List (Listar) em um arquivo de estoque, para listar os
campos referentes a nmero de produto, descrio de produto, quantidade disponvel,
custo unitrio e valor registrado para os registros com custo unitrio ou quantidade
disponvel negativa. Voc tambm pode incluir um cabealho descritivo na lista.
Informe o seguinte na caixa de texto do Log de comando:
LIST PRODNO PRODDESC QTYOH UNCST VALUE IF QTYOH < 0 OR UNCST
< 0 HEADER VALORES NEGATIVOS
O resultado do comando Listar aparece no Log de comando.
230

Locate (Buscar)
Manual de Referncia
O ACL informa que somente cinco registros atenderam ao teste. Trata-se de itens
incomuns que merecem investigao futura.
Locate (Buscar)
Use o comando Buscar para mover-se a um nmero de registro especificado ou para o
primeiro registro de um arquivo que satisfaa a uma determinada condio.
Nota: O comando Buscar corresponde s opes Localizar registro e Localizar se do
comando Pesquisar. Para acessar o comando Pesquisar, selecione Analisar na barra de
menus e escolha Pesquisar. Para obter mais informaes, consulte Search (Pesquisar) na
pgina 291.
O comando Buscar geralmente muito mais lento na localizao de um registro
especfico que a opo Localizar literal, do comando Pesquisar, j que Buscar l o
arquivo seqencialmente. Contudo, ao contrrio da opo Localizar literal, Localizar
no exige que o arquivo seja indexado primeiro. A pesquisa sempre se inicia pelo
primeiro registro (a menos que voc especifique os parmetros Enquanto ou Prximo
no comando) e no se baseia em nenhum dos campos-chave predefinidos. A velocidade
de processamento proporcional ao tamanho do arquivo e localizao do registro em
seu interior.
A opo Localizar registro geralmente usada como um modo rpido de mover-se para
um nmero de registro especfico em um arquivo com comprimento de registro fixo.
Voc tambm pode incluir os parmetros Prximo e Enquanto em um comando Buscar.
Captulo 4
Comandos
Locate (Buscar)
231
Parmetros
O comando Locate (Buscar) tem os seguintes parmetros: If (Se), First (Primeiros),
Next (Prximo), Record (Registro), While (Enquanto). Para obter uma descrio desses
parmetros, consulte o Captulo 3: Definir arquivos e campos.

LOCATE <IF teste> <WHILE teste> <FIRST|NEXT intervalo>
LOCATE RECORD n
n nmero de registro a ser localizado.
Exemplo
Neste exemplo, voc busca o primeiro registro que satisfaz a uma condio especificada
em um arquivo ordenado.
Para buscar o primeiro item do estoque comeando pela palavra PLYWOOD em um
arquivo ordenado por descrio de produto, use Locate (Buscar). Como o arquivo
ordenado de acordo com a descrio, todos os itens desse tipo so agrupados em
conjunto, facilitando uma anlise rpida dos produtos de madeira compensada.
Digite o seguinte na caixa de texto Log de comando:
LOCATE IF PRODDESC = 'PLYWOOD'
O Log de comando indica o primeiro nmero de registro que satisfaz a condio.
O registro nmero 75 aparece primeiro em sua exibio. Os prximos trs registros

tambm descrevem produtos de madeira:
232

Loop
Manual de Referncia
Loop
Utilize o comando Loop no comando Grupo para processar um registro mais de uma
vez. Os loops so utilizados com freqncia quando um registro contm informaes
repetidas, s vezes chamadas de buckets ou segmentos, que voc quer processar. Os
comandos entre Loop e End (Fim) so executados repetidamente no registro atual at
que o resultado do teste seja falso.
Os loops podem ser utilizados somente nos grupos. Antes de criar um loop, voc deve
estar familiarizado com os conceitos envolvidos na criao de grupos. Para obter mais
informaes, consulte Group (Grupo) na pgina 198.
Parmetros
O comando Loop tem o seguinte parmetro: While (Enquanto). Para obter uma
descrio, consulte o Captulo 3: Definir arquivos e campos.
Caixa de dilogo Loop

Clique em
(Loop) em uma janela de batch para exibir a caixa de dilogo Loop.
Exemplo
Para criar um loop, siga esses passos:
1. Abra um batch. O ACL exibir a janela de batch.
2. Posicione o cursor em um Grupo.
3. Clique em
(Loop). O ACL exibir a caixa de dilogo Loop.
Captulo 4
Comandos
Loop
233
4. Execute um dos seguintes procedimentos:
Digite uma expresso na caixa de texto Enquanto.

Crie uma expresso clicando em [Enquanto] e utilizando o Construtor de
expresses.
5. Clique em [OK] para fechar a caixa de dilogo Loop.

6. Digite os comandos.
7. Digite um comando End para fechar o loop.

Cada comando Loop deve ser fechado com um comando End (Fim). Em um loop voc
deve especificar os parmetros While (Enquanto) para testar uma condio. Os
comandos entre Loop e End so executados repetidamente para o registro atual,
enquanto o teste especificado resultar em verdadeiro. Se o resultado do teste for, inicialmente, falso, os comandos no sero executados.
Nota: Para evitar a criao de um loop infinito, certifique-se de que o teste especificado
eventualmente retornar falso. Voc tambm pode usar a opo Loop do comando Set
(Definir) para impedir um loop infinito. Consulte Set Loop (Definir Loop) na pgina 307
para obter mais detalhes.
LOOP WHILE teste
comandos
...
END
Exemplo
O comando Loop a seguir totaliza 100 campos repetidos em um registro, supondo-se
que cada um tenha cinco bytes de tamanho:
GROUP
COUNT=0
TOTAL=0
LOOP WHILE COUNT<100
TOTAL=TOTAL+OFFSET(AMOUNT;COUNT*5)
COUNT=COUNT+1
END
END
234

Merge (Mesclar)
Manual de Referncia
Merge (Mesclar)
Use o comando Mesclar para combinar dois arquivos ordenados, contendo estruturas
de registro idnticas, em um terceiro arquivo. Por exemplo, voc pode usar Mesclar para
combinar dois arquivos contendo estruturas de registro idnticas de diferentes perodos
de tempo, diferentes filiais da empresa e assim por diante.
Para combinar campos de um arquivo de Cadastro e um de Transaes que tenham
estruturas diferentes, consulte Join (Associar) na pgina 218.
Mesclar coloca os registros de sada mesclados de ambos os arquivos primrio e secundrio em um terceiro arquivo de sada. Todos os aspectos dos registros permanecem
inalterados e as seqncias de ordenao so mantidas. Para cada valor do
campo-chave, os registros do arquivo de entrada primrio so posicionados antes dos
registros do secundrio.
Os arquivos de entrada primrio e secundrio devem, necessariamente, ter estruturas
idnticas, embora os campos referentes aos dois arquivos no precisem ter os mesmos
nomes.
O comando Mesclar produz um arquivo de entrada, juntamente com uma definio de
arquivo. Esse novo arquivo pode ser usado para anlise posterior e gerao de relatrio
com o ACL.
Nota: Os parmetros Se, Enquanto, Primeiros e Prximo que limitam registros selecionados para a sada aplicam-se somente ao arquivo de entrada primrio.
Nota: Ao processar arquivos do servidor que contm arquivos relacionados, a sada tipo
registro ser alterada para sada de todos os campos se voc especificar a opo ou a
palavra-chave local.
Consulte Extract (Extrair) na pgina 186 para obter as alternativas possveis.
Pr-requisitos
Para usar a linha de comando, voc precisa abrir o arquivo secundrio, bem como o
primrio, antes de emitir um comando.
Os arquivos primrio e secundrio devem ter, necessariamente, estruturas de registro
idnticas. Do contrrio, os resultados so imprevisveis.
Tanto o arquivo primrio, como o secundrio devem ser ordenados em seqncia
crescente nos campos-chave tipo caractere. Voc pode marcar a caixa de seleo
Pr-ordenar da caixa de dilogo Mesclar para ordenar o arquivo primrio. O arquivo
primrio pode ser indexado em vez de ordenado, se voc desejar. Os campos-chave
devem necessariamente ser campos de caractere. Caso contrrio, utilize a funo
Captulo 4
Comandos
Merge (Mesclar)
235
STRING( ) para converter os campos-chave em campos de caracteres, ou a funo

DATE( ) para converter uma data. O comprimento total dos campos de caractere deve
ser o mesmo em ambos os arquivos de entrada.
Parmetros
Alm dos parmetros descritos a seguir, o comando Merge (Mesclar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros), If
(Se), Local (Local), Next (Prximo), To (Para), Use Output File (Usar arquivo de sada),
While (Enquanto). Para obter uma descrio desses parmetros, consulte o Captulo 3:
Marque a caixa de seleo Pr-ordenar para ordenar o arquivo primrio pelas chaves
primrias, antes de mesclar os arquivos.
Primary Keys (Chaves primrias)

Especifica as chaves tipo caractere do arquivo de entrada primrio a serem mescladas.
Selecione os campos-chave na exibio de lista, ou clique em [Chaves primrias] para
Secondary File (Arquivo secundrio)

Permite selecionar o arquivo secundrio a ser mesclado com o arquivo primrio.
Selecione o arquivo da lista suspensa.
Secondary Keys (Chaves secundrias)

Especifica as chaves tipo caractere do arquivo de entrada secundrio a serem mescladas.
Selecione os campos-chave na exibio de lista ou clique em [Chaves secundrias] para
Consulte STRING( ) na pgina 80 e DATE( ) na pgina 39 para obter mais detalhes
sobre a converso de campos numricos e tipo data em campos de caractere.
Para obter mais informaes sobre a caixa de dilogo Campos selecionados, consulte
Caixas de dilogo na pgina 34 do Guia do Usurio do ACL para Windows.
Caixa de dilogo Mesclar

Clique em
(Mesclar) ou selecione Dados da barra de menus, para exibir a caixa de
dilogo Mesclar.
236

Merge (Mesclar)
Manual de Referncia
Exemplo
conveniente ter um livro razo contbil anual atualizado para a anlise das transaes
contbeis. Use o razo geral do primeiro trimestre como o arquivo primrio e o razo
geral do segundo trimestre como o arquivo secundrio.
D a seu arquivo primrio o nome de GLQTR1 e certifique-se de que GLQTR1 e
GLQTR2 sejam ordenados pelo campo de nmero de conta do razo geral. Na caixa de
dilogo Mesclar, selecione GLQTR2 como seu arquivo secundrio e identifique o campo
de nmero de conta como o campo-chave para ambos os arquivos.
O novo arquivo, Gl_jan_to_jun, relaciona (por nmero de conta) todos os registros do
primeiro trimestre, antes daqueles do segundo trimestre. Todos os aspectos dos
registros permanecem inalterados e as seqncias de ordenao so mantidas.
Captulo 4
Comandos
Notify (Notificar)
237

MERGE ON lista-de-campos-chave
MERGE PKEY campos-chave-primrios SKEY
campos-chave-secundrios
Voc pode incluir as seguintes opes em qualquer formato de sintaxe:

TO nome-do-arquivo-a-ser-criado
<PRESORT>
<IF teste> <WHILE teste> <NEXT|FIRST intervalo>
<APPEND>
<OPEN>
Nota: No possvel usar a palavra-chave Pr-ordenar em um grupo de comandos que

esteja sendo executado no modo batch.
Use a primeira variao da sintaxe do comando quando os nomes dos campos-chave de
ambos os arquivos forem idnticos e forem campos, no expresses. Do contrrio, use a
segunda variao.
Notify (Notificar)
Use o comando Notificar para enviar arquivos ou informaes sobre o batch em forma
de mensagem ou anexo para endereos de e-mail locais ou remotos. Voc pode enviar a
mensagem para mais de uma pessoa, contanto que seu sistema de e-mail permita vrios
destinatrios.
O comando Notificar funciona com uma variedade de protocolos de e-mail, incluindo
os aplicativos de e-mail VIM para ccMail, MAPI para aplicaes de e-mail da Microsoft
e SMTP para servidores externos.
O comando Notificar um utilitrio exclusivo para envio, no sendo previsto para ser
utilizado como um sistema de correio completo.
Parmetros
O comando Notify (Notificar) tem os seguintes parmetros: Mailbox (Caixa Postal),
Address (Endereo), Message (Mensagem), Password (Senha), User (Usurio).
Address (Endereo)
Especifica os nomes dos destinatrios de e-mails locais e remotos. Separe os nomes e
endereos de vrios destinatrios com uma vrgula.
238

Notify (Notificar)
Manual de Referncia
Mailbox (Caixa postal)

Especifica um caminho para uma caixa de correio local ou para um nome de servidor
SMTP.
Message (Mensagem)
Especifica o texto da mensagem.
Nota: Se voc estiver utilizando uma aplicao de e-mail da Microsoft, verifique se ela
est ativo antes de iniciar o batch. Caso contrrio, ser exibida uma mensagem do
Windows solicitando a seleo de um perfil de e-mail. Isto pode fazer com que o batch seja
interrompido.
Password (Senha)
Especifica sua senha para e-mails locais.
User (Usurio)
Especifica seu nome de usurio para um sistema local ou seu endereo de e-mail para
um servidor SMTP.
Caixa de dilogo Notificar

Selecione Arquivo da barra de menus e escolha Notificar para exibir a caixa de dilogo
Notificar. As informaes fornecidas dependem se voc est enviando um e-mail local
ou remoto. Nem todos os protocolos exigem que voc digite informaes em cada caixa
de texto.
E-mail local
Especifique uma caixa de correio local na caixa de texto Caminho da caixa postal.
Separe vrios destinatrios com uma vrgula.
Clique em [Procurar] para selecionar um arquivo ou batch para adicionar mensagem.
Captulo 4
Comandos
Notify (Notificar)
239
E-mail remoto
Especifique o endereo do servidor SMTP na caixa de texto Caminho da caixa postal.
Separe vrios destinatrios com uma vrgula.
Clique em [Procurar] para selecionar um arquivo ou batch para adicionar mensagem.

NOTIFY USER nome-do-usurio <PASSWORD xxxx> MAILBOX
nome-do-caminho ADDRESS destinatrio MESSAGE mensagem
240

Open (Abrir)
Manual de Referncia
Open (Abrir)
Use o comando Abrir para abrir um novo arquivo de entrada. O ACL usar a extenso
de arquivo .fil, se nenhuma outra extenso for especificada.
Nota: A janela Viso geral a melhor maneira de abrir um arquivo de dados. Voc
tambm pode selecionar Dados na barra de menu e escolher Selecionar. A abertura de um
arquivo de dados usando qualquer um desses mtodos mais prtica que a emisso do
comando Abrir.
Se o arquivo tiver uma extenso .dbf ou se voc especificar a opo dBASE na sintaxe do
comando, o ACL ir considerar o arquivo como sendo um arquivo de entrada dBASE e
ir ler a definio de arquivo de entrada diretamente a partir do mesmo. O ACL detecta
automaticamente e se ajusta de acordo com as diferenas entre as vrias verses do
dBASE.
Se um arquivo de entrada j estiver aberto o ACL fechar automaticamente o arquivo
antes de executar este comando.
Parmetros
O comando Open (Abrir) tem os seguintes parmetros: Bufferlength (Comprimento do
buffer), CRLF, dBASE, Tape (Fita), Format (Formato), Skip (Ignorar), Index (ndice),
Relation (Relacionamento), Secondary (Secundrio).
Bufferlength (Comprimento do buffer)

Especifica o comprimento (em bytes) da rea do buffer de entrada a ser alocada para o
arquivo. As reas de buffer maiores aumentam a velocidade de processamento, s custas
da RAM disponvel para o armazenamento de comandos do ACL.
Se algum bloco de um arquivo de tamanho de registro varivel tipo IBM for lido e
exceder a capacidade do buffer, o ACL exibir uma mensagem de erro e interromper o
processamento.
O Comprimento do Buffer controlado pela preferncia Tamanho do buffer. Para
aumentar ou diminuir o comprimento do buffer, selecione Editar na barra de menu e
escolha Preferncias. Clique na guia [Opes do arquivo de entrada] e digite o comprimento do buffer na caixa de texto Tamanho do buffer.
Voc deve especificar um comprimento de buffer ao abrir uma fita. Se voc omitir o
parmetro, o ACL solicitar a informao. O comprimento do buffer deve ter o
tamanho do bloco da fita, em bytes. Se algum bloco de fita exceder o tamanho do buffer,
o ACL exibir uma mensagem de erro e interromper o processamento.
Captulo 4
Comandos
Open (Abrir)
241
Raramente haver necessidade de alterar esse parmetro, j que o padro suficiente

para tratar de praticamente todas as situaes. Padro: 15.000 bytes.
CRLF
Indica que um arquivo ASCII de comprimento varivel deve ser lido. O ACL se ajusta
automaticamente s variaes de comprimento de registro. Padro: Arquivo de comprimento fixo.
dBASE
Indica que os dados de entrada so de um arquivo dBASE. O ACL reconhece o tipo do
Arquivo dBASE (dBASE II, III, III+, IV, etc.) e cria automaticamente uma definio de
arquivo de entrada, a partir da descrio do arquivo.
Voc pode extender as definies de campo do dBASE com os campos calculados do
ACL.
Esse parmetro usado para arquivos com extenso .dbf. Padro: Arquivo no-dBASE.
Format (Formato)
Especifica a definio de arquivo de entrada (conforme exibida na janela Viso geral) a
ser associado ao arquivo de dados especificado.
Index (ndice)
A opo ndice indica que um arquivo de ndice dever ser aberto para acessar o arquivo
em ordem lgica, em vez de fsica. A extenso de arquivo usada para o nome de arquivo
de ndice .inx, quando no for especificada nenhuma extenso. Voc no pode especificar ndice com arquivos secundrios. Padro: Nenhum arquivo de ndice.
Relation (Relacionamentos)
Indica que o arquivo dever ser aberto como um arquivo relacionado especial. O ACL
no mantm o relacionamento para arquivos relacionados especiais. Voc deve especificar ndice com arquivos relacionados.
Secondary (Secundrio)
Indica que deve ser aberto um arquivo secundrio, em vez do arquivo primrio. Voc
no pode especificar Secundrio em conjunto com ndice ou Fita.
Padro: Primrio.
242

Open (Abrir)
Manual de Referncia
Skip (Ignorar)
Indica que um determinado nmero de bytes ser ignorado no incio fsico do arquivo.
O comando Ignorar pode ser usado para ignorar registros do cabealho do arquivo ou
pores do incio do arquivo que no seguem o layout do restante do mesmo.
Padro: 0.
Tape (Fita)
Indica que h uma unidade de fita ou cartucho anexada que deve ser lida. Voc no pode
emitir Abrir fita como um arquivo secundrio. Consulte Apndice B: Trabalhar com
fita para obter detalhes sobre como abrir um arquivo armazenado em uma fita
magntica.

OPEN nome-do-arquivo-de-entrada
OPEN {nome-do-arquivo-de-dados|TAPE}
<FORMAT nome-do-arquivo-de-entrada>
<BUFFERLENGTH n>
<CRLF>
<DBASE>
<INDEX nome-do-arquivo-de-ndice>
<PRIMARY|SECONDARY>
<SKIP valor>
<RELATION expresso-chave>
nome-do-arquivo-de-entrada o nome do arquivo de entrada que voc quer
abrir (como exibido na janela Viso geral, se j foi criado). Tambm selecionado o
arquivo de dados usado por ltimo.
nome-do-arquivo-de-dados o nome do novo arquivo de dados que ser
associado ao arquivo de entrada especificado aps o parmetro Formato. Este arquivo

de dados substitui o anterior at que seja especificado um arquivo diferente.
expresso-chave esta uma expresso tipo caractere, baseada nos arquivos j
abertos, usada para localizar registros relacionados neste arquivo.
Exemplo 1
Para abrir um arquivo de entrada do contas a receber, Ar, use Open (Abrir). Digite
OPEN AR na caixa de texto do Log do comando.
A barra de status indica que o arquivo Ar est aberto.
Captulo 4
Comandos
Password (Senha)
243
Exemplo 2
Para abrir uma definio de arquivo de entrada Ar, mas associ-lo a um novo arquivo de
dados denominado Cutoff.fil, digite OPEN CUTOFF.FIL FORMAT AR na caixa de
texto do Log do comando.
Exemplo 3
Para abrir o arquivo dBASE denominado Test.dbf no acessado anteriormente, digite
OPEN TEST.DBF na caixa de texto do Log de comando.
Password (Senha)
Muitos arquivos ODBC so protegidos por senha. Use o comando Senha para solicit-la
ao usurio e poder importar ou atualizar arquivos de dados que exijam senhas.
Este comando s pode ser executado no modo de comandos. Esse o mtodo preferido
para solicitar senhas de usurio em batches.
A senha digitada pelo usurio exibida como asteriscos (*) na caixa de dilogo. A senha
real nunca exibida nem registrada no Log de comando e fica acessvel apenas aos
comandos Importar e Atualizar.
O comando Senha bastante til nos batches, de forma que voc pode obter as senhas
necessrias para importar ou atualizar tabelas de banco de dados ODBC antes de
analis-las. possvel armazenar at cinco senhas em um arquivo batch. Para obter mais
informaes, consulte Set Echo (Definir eco) na pgina 305.

PASSWORD n <solicitao>
n deve ser um valor de 1 a 5.
solicitao pode ser qualquer expresso de caractere vlida.
Exemplo
Use o comando Password (Senha) seguido do comando Import (Importar) para
importar um arquivo de dados protegido por senha:
PASSWORD 1 "Digite a senha da folha de pagamento:"
IMPORT PAYROLL.FIL PASSWORD 1
244

Pause (Pausa)
Manual de Referncia
Pause (Pausa)
Use o comando Pausa para criar uma mensagem personalizada, como uma mensagem
de erro ou explicao de entrada. A mensagem aparece em uma caixa de dilogo.
Nota: Pausa til para exibir uma mensagem ou aviso durante a execuo de um batch.
O comando Pausa no deve ser aplicado registro a registro, portanto no pode ser includo
em um grupo.
ACL para Windows.
Parmetros
O comando Pause (Pausa) tem o seguinte parmetro: If (Se). Para obter uma descrio,

PAUSE mensagem <IF teste>
mensagem especifica qualquer cadeia vlida de at 200 caracteres.
Exemplo
Para exibir uma mensagem para o usurio em um batch, digite o seguinte comando na
caixa de texto do Log do comando:
PAUSE 'A classe do produto deve ser um valor de 2 dgitos.'
O ACL exibe a solicitao no ponto apropriado, quando o batch for executado:
Captulo 4
Comandos
Profile (Perfil)
245
Profile (Perfil)
Use o comando Perfil para fornecer estatsticas resumidas sobre um ou mais campos
numricos em um arquivo de entrada.
O comando Perfil fornece as seguintes informaes sobre campos numricos:
Valor total
Valor absoluto
Valor mnimo
Valor mximo
O comando Perfil usado principalmente para determinar os valores mnimo, mximo,

absoluto e total dos campos (conforme apropriado), antes de emitir os comandos Estratificar, Histograma ou Amostra.
Nota: Se voc quiser obter uma viso geral de um arquivo antes de iniciar o processamento
detalhado, o comando Estatsticas fornece informaes mais completas.
Depois do perfil de um campo ter sido definido, o ACL passa a conhecer seus valores
mnimos e mximos. Esses valores so usados como padro para os parmetros
Mnimo e Mximo, nos comandos Estratificar e Histograma. De forma semelhante, o
ACL conhece o valor absoluto do campo e usa esse valor como o padro para o
parmetro Populao, no comando Amostra.
Se a opo de arquivo de entrada Mostrar perfil automaticamente ao abrir estiver ativa,o
ACL ir produzir, automaticamente, um perfil de todos os campos numricos de um
arquivo toda vez que um novo arquivo de entrada for aberto. Os perfis podem ser visualizados no Log de comando. Para ativar essa opo, selecione Editar na barra de menu e
escolha Preferncias. Clique na guia [Opes do arquivo de entrada] e selecione
Mostrar perfil automaticamente ao abrir.
Parmetros
Alm dos parmetros descritos a seguir, o comando Profile (Perfil) tem os seguintes
parmetros: All (Tudo), First (Primeiros), If (Se), Next (Prximo), While (Enquanto).
246

Profile (Perfil)
Manual de Referncia
Para obter a descrio desses parmetros, consulte o Captulo 3: Parmetros de

comandos comuns.
Profile Fields (Campos de perfil)

Especifica os campos numricos do arquivo de entrada a ter os seus perfis definidos.
Selecione os campos na caixa de listagem ou clique em [Campos de perfil] para abrir a
caixa de dilogo Campos selecionados. Para obter mais informaes, consulte Caixas
de dilogo na pgina 34 do Guia do Usurio do ACL para Windows.
Caixa de dilogo Perfil

Clique em
(Perfil) ou em Analisar, a partir da barra de menus e selecione Perfil, para
exibir a caixa de dilogo Perfil.
Exemplo
Use Perfil para obter o valor absoluto de um campo de valor de estoque. Voc pode em
seguida usar esse valor como sendo o tamanho da populao padro referente a uma
amostra por unidade monetria (MUS) aleatria, no campo.
Captulo 4
Comandos
Profile (Perfil)
247
O ACL exibe o resultado no Log do comando.
O total $680.479,94, o valor absoluto $708.243,94, o valor mnimo -$10.167,60 e o

mximo $100.800,00.
O ACL fornece automaticamente $708.243,94 como o valor padro para o parmetro
Populao em qualquer amostra MUS aleatria subseqente, gerada para o campo
Value, at que o arquivo seja fechado.
248

Quit (Sair)
Manual de Referncia
Da mesma forma, o ACL fornece automaticamente os valores mnimo e mximo de

qualquer comando Histograma e Estratificar que voc executar no campo Value.

PROFILE lista-de-campos-numricos
Quit (Sair)
Use o comando Sair para finalizar uma sesso do ACL.
Este comando s pode ser executado no modo de comandos. Para obter mais informaes, consulte Usar comandos na pgina 260 do Guia do Usurio do
ACL para Windows.
Todos os arquivos abertos so salvos e fechados antes de encerrar. Se voc alterou a
exibio atual ou um batch aberto e no salvou as alteraes, o ACL exibir uma
mensagem perguntando se deseja salvar as alteraes antes de sair.
Captulo 4
Comandos
Random (Aleatrio)
249
Este comando particularmente til quando voc deseja ter um batch que saia do ACL
quando concludo.
Nota: Voc pode sair de uma sesso do ACL selecionando Arquivo, na barra de menus e
escolhendo Sair, o que mais prtico que emitir o comando Sair.
Consulte Sair do ACL na pgina 57 do Guia do Usurio do ACL para Windows para
obter mais detalhes.

QUIT
Random (Aleatrio)
Use o comando Aleatrio para gerar nmeros aleatrios a serem usados em outros
programas que no o ACL.
O comando Aleatrio gera a quantidade especificada de nmeros inteiros aleatrios, a
partir de uma determinada faixa de valores e os exibe em colunas. Voc pode fazer com
que o ACL selecione apenas valores nicos (isto , sem duplicatas) e exiba os nmeros
aleatrios em ordem crescente.
Cada nmero aleatrio gerado ser maior ou igual ao valor mnimo e menor que o valor
mximo especificado. Nenhum nmero aleatrio igual ao valor mximo. Por exemplo,
se voc especificar 0 como nmero mnimo e 100 como nmero mximo, o ACL ir
gerar nmeros aleatrios que variam de 0 a 99.
Parmetros
Alm dos parmetros descritos a seguir, o comando Random (Aleatrio) tem os
seguintes parmetros: As (Como), File (Arquivo), File Type (Tipo de arquivo), Footer
(Rodap), Header (Cabealho), Local (Local), Name (Nome), Screen (Tela), To (Para).
Para obter uma descrio desses parmetros, consulte o Captulo 3: Parmetros de
comandos comuns.
Columns (Colunas)
Especifica o nmero de colunas a ser usado para exibir os nmeros. Digite um nmero
ou use setas para aumentar ou diminuir o nmero mostrado. Padro: 6.
250

Random (Aleatrio)
Manual de Referncia
Maximum (Mximo)
Especifica o limite superior do intervalo para gerao dos nmeros aleatrios.
permitido o uso de qualquer expresso ou valor numrico vlido. Os valores Mximo e
Mnimo devem ser especificados juntos.
Minimum (Mnimo)
Especifica o limite inferior do intervalo de gerao dos nmeros aleatrios. permitido
o uso de qualquer expresso ou valor numrico vlido. Os valores Mnimo e Mximo
devem ser especificados juntos.
Number (Nmero)
Especifica a quantidade de nmeros aleatrios a serem gerados. Digite um nmero.
Seed (Origem)
Especifica o ponto de partida para o gerador de nmeros aleatrios. Se um comando
Aleatrio for duplicado com o mesmo valor de origem, a seqncia de nmeros
aleatrios ser identicamente reproduzida. O ACL substitui um valor zero de origem
por um nmero aleatrio. Padro: Gerado internamente.
Sorted (Ordenado)
Faz com que a lista de nmeros de sada seja apresentada em ordem crescente. Padro:
No ordenado.
Unique (Exclusivo)
Faz com que somente nmeros exclusivos sejam includos na sada. Quando voc
seleciona Exclusivo, cada nmero aleatrio gerado comparado com a lista inteira de
nmeros anteriores gerados para esse comando. Se for uma repetio, o nmero
descartado sem substituio.
Voc no deve selecionar Exclusivo quando a quantidade de nmeros aleatrios a serem
gerados excede 75% do intervalo, j que isso pode fazer com que uma quantidade
excessiva de nmeros seja descartada. Padro: Duplicaes permitidas.
Caixa de dilogo Aleatrio

Clique em
(Aleatrio) ou em Ferramentas, na barra de menus e selecione Aleatrio
para exibir a caixa de dilogo Aleatrio.
Captulo 4
Comandos
Random (Aleatrio)
251
Exemplo
Para gerar 10 nmeros aleatrios exclusivos entre 1 e 1000, ordenados em seqncia
crescente, em duas colunas, use Aleatrio.
Os 10 nmeros aparecem no Log de comando.
252

Refresh (Atualizar)
Manual de Referncia
Os nmeros aleatrios gerados so listados na seqncia de ordenao, da esquerda

para a direita, sendo lidos de cima para baixo. Nenhum nmero repetido. Se alguma
duplicao tivesse ocorrido neste exemplo, teria sido descartada e um outro nmero
seria escolhido.

RANDOM NUMBER=n
<SEED valor-de-origem>
MINIMUM mn
MAXIMUM mx
<UNIQUE>
<COLUMNS colunas-de-sada>
<SORTED>
<TO nome-do-arquivo|PRINT>
<APPEND>
Refresh (Atualizar)
Use Refresh para atualizar arquivos planos criados por ocasio da importao de dados
de uma fonte externa.
Em um lote, voc pode atualizar e ento analisar o arquivo, como faria com qualquer
outro arquivo de dados. Consulte Import (Importar) na pgina 210 para obter
detalhes.
O comando Refresh substitui apenas o arquivo de dados associado e no atualiza
automaticamente as definies de campo. O comando Refresh supe que o formato do
arquivo-fonte seja idntico ao de quando foi originariamente definido no
ACL para Windows. Se este no for o caso, voc deve importar os dados novamente.
Parmetros
O comando Refresh (Atualizar) tem o seguinte parmetro: Password (Senha).
Captulo 4
Comandos
Relations (Relacionamentos)
253
Password (Senha)
Se voc precisar de uma senha para atualizar dados de uma origem externa, use o
comando Password. Consulte Password (Senha) na pgina 243 para obter detalhes.
Boto Atualizar a partir do arquivo fonte

Voc pode atualizar seus dados usando o boto Atualizar a partir do arquivo-fonte, das
seguintes maneiras:
Na janela Viso geral, selecione o nome da definio de arquivo de entrada. Em

seguida, clique em
(Atualizar a partir do arquivo-fonte).
Na janela Definio de arquivo de entrada, clique em
arquivo-fonte) na guia [Opes do arquivo de entrada].
(Atualizar a partir do

REFRESH <nome_da_definio_do_arquivo_de_entrada> <PASSWORD
n>
nome_da_definio_do_arquivo_de_entrada o nome da definio do arquivo
de entrada que voc criou quando importou seus dados. Quando voc atualiza esse
arquivo, os arquivos de dados associados a ele so atualizados e sobrescritos sem aviso.
O comando Relacionamentos permite acessar e analisar simultaneamente os dados de
dois ou mais arquivos, dois arquivos por vez. Voc pode analisar os dados combinados
como se existissem em um arquivo nico e adicionar campos a partir dos arquivos
relacionados a uma exibio.
Como voc est trabalhando com dados de arquivos diferentes, pode utilizar o
comando Relacionamentos para examinar os relacionamentos previstos e descobrir
alguns no esperados. Alm disso, pode criar um novo arquivo contendo os campos de
dados relacionados, utilizando o comando Extrair. O comando Relacionamentos
produz resultado similar ao do comando Associar com a opo Todos primrios selecionada.
Dois arquivos a serem relacionados devem ter um campo-chave comum. O
campo-chave deve ser um campo de caractere que contm o mesmo tipo de dados.
Todos os arquivos relacionados devem ser definidos no mesmo Projeto ACL.
254

Manual de Referncia
Arquivos pai e filho

Os relacionamentos de dados criados com o comando Relacionamentos so hierrquicos. O arquivo primrio chamado arquivo pai e os arquivos dependentes so
chamados arquivos relacionados ou filhos. Um pai pode ter muitos arquivos filhos. Os
arquivos filhos tambm podem ser pais, com seus prprios arquivos filhos. Um arquivo
pai tambm pode ser relacionado com ele mesmo. Um relacionamento de neto deve ser
criado a partir do pai.
Voc inicia um relacionamento abrindo um arquivo pai na exibio. O arquivo pai no
precisa ser ordenado ou indexado. Uma vez estabelecido o relacionamento, pode-se
adicionar campos a partir do arquivo filho para serem exibidos ou acessados de outras
maneiras para fins de anlise. Os campos relacionados s podem ser visualizados no
arquivo pai.
O ACL permite nomear cada relacionamento individualmente. Isso permite estabelecer
mais de um relacionamento entre um arquivo pai e um arquivo relacionado, e permite
relacionar um arquivo pai consigo mesmo.
Um arquivo pai ACL pode referenciar-se ativamente com as informaes de at 17
arquivos relacionados. Um Projeto ACL pode ter vrios arquivos pai. O ACL armazena
todos os relacionamentos e campos relacionados em seu Projeto ACL, at serem
excludos.
H um relacionamento muitos para um entre um arquivo pai e um filho. O arquivo pai
pode ter registros ausentes ou em duplicidade no campo-chave. O arquivo filho no
pode ter registros ausentes ou em duplicidade no campo-chave.
O ACL compara os dois arquivos, de acordo com o contedo do campo-chave, registro
por registro. O contedo do campo-chave em cada arquivo deve ser idntico, para que
se possa obter uma correspondncia. Quando os dados no campo-chave so idnticos,
o ACL pode relacionar, ou virtualmente associar, os dados contidos no registro do
arquivo filho com o registro correspondente no arquivo pai.
Quando houver registros duplicados no campo-chave do arquivo filho, o ACL faz a
correspondncia com a primeira ocorrncia da chave. As chaves duplicadas remanescentes so ignoradas. Se no houver registro correspondente no arquivo relacionado, o
ACL ir exibir um espao em branco para campos de caractere e data, zero para campos
numricos e F para campos lgicos.
Pr-requisitos para o relacionamento de arquivos

Os arquivos que voc relaciona devem conter um campo-chave e devem ser definidos no
mesmo Projeto ACL. Ao trabalhar com o Sistema ACL Cliente/Servidor, todos os
Captulo 4
Comandos
255
arquivos a serem relacionados e seus ndices devem estar no mesmo servidor. Voc no
pode relacionar um arquivo da unidade local com um arquivo do servidor.
Antes de relacionar dois arquivos, voc deve:
Certificar-se de que o campo-chave seja ASCII
Certificar-se de que cada arquivo tenha um campo-chave
Certificar-se de que os campos-chave esto normalizados
Indexar o arquivo relacionado (filho) pelo campo-chave
Escolha dos campos-chave

O campo-chave o elemento comum que permite que os dados de dois arquivos sejam
relacionados. Para obter resultados significativos, os campos-chave devem ser idnticos
em diversos pontos, exceto no nome. Os campos-chave devem ter as seguintes caractersticas:
Devem ser campos de caractere
Devem ter o mesmo comprimento de campo
Devem ter os dados alinhados da mesma maneira ( esquerda ou direita)
Devem ter os dados formatados da mesma maneira (mesma ortografia, mesmo

uso de maisculas, mesma pontuao)
Eles tambm podem ser campos calculados. Ou seja, voc pode criar um campo
calculado para funcionar como o campo-chave.
Normalizar campos-chave
Os campos-chave, tanto nos arquivos pai, como nos arquivos filho, devem ser campos
de caracteres ou expresses, com estrutura idntica. s vezes necessrio modificar ou
normalizar o contedo de um campo antes de us-lo como campo-chave. Voc pode
utilizar funes do ACL para converter campos no formato de caractere e modificar seu
contedo.
Voc pode utilizar funes no Construtor de expresses, tais como STRING( ) ou
DATE( ), para converter campos para o formato de caractere. Consulte Construtor de
expresses na pgina 275 do Guia do Usurio do ACL para Windows para obter mais
detalhes. Outras funes permitem combinar dois campos em um, diminuir campos ou
modificar a estrutura de vrias maneiras, para fazer com que se adaptem para serem
utilizadas como campos-chave.
Por exemplo, em um arquivo, o campo do nmero do cliente pode ser numrico. Voc
pode criar um novo campo calculado para ser o campo-chave e utilizar a funo
256

Manual de Referncia
STRING( ) para converter os dados numricos em dados de caractere. Da mesma

maneira, pode utilizar outras opes e funes do ACL para verificar se os campos tm
o mesmo comprimento, se esto ambos alinhados direita ou esquerda, substituir as
palavras por abreviaturas, converter caracteres em letras minsculas ou maisculas,
inserir ou excluir caracteres ou espaos, etc.
Escolher arquivos relacionados

H vrios fatores a considerar antes de decidir qual arquivo deve ser pai e qual deve ser
relacionado ou filho:
Considere o relacionamento muitos para um entre as chaves do arquivo pai e as chaves
do arquivo relacionado. O ACL combina cada chave no arquivo pai com a primeira
chave correspondente no arquivo relacionado. Isso pode afetar sua deciso sobre qual
arquivo deve ser o pai e qual deve ser o arquivo relacionado.
Outra forma de dizer isso que o arquivo pai deve conter todos os registros que voc
quer analisar. Por exemplo, se voc tiver um arquivo Contas a Receber (Ar) com 500
faturas (registros) e um arquivo Customer (Clientes) com 100 registros, a escolha do
arquivo Ar como arquivo pai permitir a voc analisar todas as 500 faturas. Por outro
lado, se voc escolher o arquivo Cliente como arquivo pai, poder apenas analisar 100
registros, isto , uma fatura para cada cliente.
Considere tambm que o relacionamento estabelecido em uma s direo, do pai para
o filho. Somente um arquivo pai pode acessar os campos de um arquivo filho. Um
arquivo filho no tem informaes sobre seu arquivo pai.
Finalmente, lembre-se de que os arquivos relacionados devem ser definidos dentro do
mesmo Projeto ACL do arquivo pai.
Indexar arquivos relacionados por seus campos-chave

Depois de selecionar o arquivo relacionado e verificar se o campo-chave est normalizado, voc precisa indexar o arquivo relacionado pelo campo-chave, utilizando o
comando ndice. Para obter mais informaes, consulte Index (ndice) na pgina 211.
Nota: No necessrio indexar ou ordenar o campo relacionado no arquivo pai, entretanto voc deve indexar o arquivo filho pelo campo relacionado comum.
Antes de criar um novo ndice, verifique se j no existe um. Para obter informaes
sobre como exibir ndices, consulte Janela Viso geral na pgina 29 do
Guia do Usurio do ACL para Windows. Alm disso, voc pode imprimir uma lista de
Captulo 4
Comandos
257
ndices. Para obter mais informaes, consulte Imprimir documentao na

Nota: Se um arquivo de ndice ficar desatualizado, o ACL automaticamente recriar o
arquivo usando o mesmo nome.
No utilize filtros ao criar este ndice. Se voc precisar aplicar condies aos dados,
aplique-as ao arquivo pai e aos campos relacionados depois de estabelecer o relacionamento.
Salve o ndice com um nome de arquivo representativo, pois precisar utiliz-lo como
referncia ao definir os relacionamentos de dados.
Planejar relacionamentos entre arquivos de dados

Os relacionamentos de dados bem sucedidos exigem um planejamento cuidadoso.
Determine quais arquivos contm campos que voc precisa relacionar e considere a
maneira mais eficiente para relacion-los.
Por exemplo, voc pode precisar analisar dados que esto em diversos arquivos
diferentes. Voc precisar identificar quais arquivos contm os campos de dados necessrios e quais campos adicionais podem servir como campos-chave. Isso til para
criar um diagrama com o fim de identificar as possibilidades de relacionamento.
Customer (arquivo filho)
Ar (arquivo pai)
No
No do cliente
Customer
Number
do pedido
Data do pedido
Nome do cliente
No do cliente
Endereo
No
Limite de crdito
do contrato
Quantia do pedido
Arquivos a
serem
comparados
Contract (arquivo filho)
Sales Rep (arquivo filho)
No
No do representante.
do contrato
Data do contrato
Nome do representante.
Tipo de contrato
Endereo
No
Vendas YTD
do representante.
O arquivo Ar e o arquivo Customer, por exemplo, contm um campo Cdigo do Cliente

(NO) que pode ser utilizado como um campo-chave na formao de um relaciona-
258

Manual de Referncia
mento entre esses dois arquivos. Esse relacionamento proporciona acesso a todos os
campos no arquivo Ar, bem como aos campos pertinentes no arquivo Customer: Nome
(NAME) e Limite de Crdito (LIMIT).
Depois de estabelecido um relacionamento entre os dois arquivos, voc pode acessar os
campos Nome do Cliente (NAME) e Limite de Crdito (LIMIT) nos comandos que voc
emitir, a partir do arquivo Ar pai. Se quiser, tambm pode adicionar esses campos
exibio do arquivo Ar.
Ambos os arquivos relacionados Cdigo do cliente como campo-chave
Ar (arquivo pai)
Customer (arquivo filho)
Ar com campos do arquivo Customer
Voc pode adicionar campos a partir do arquivo Customer, na exibio do arquivo Ar.
O arquivo Ar tambm contm o campo Nmero do contrato, que comum ao arquivo

Contract, assim um relacionamento pode ser estabelecido entre esses dois arquivos.
Depois que o relacionamento estabelecido, o campo Cdigo do vendedor
(Sales_rep_no) pode ser acessado a partir do arquivo Ar. Se quiser, voc tambm pode
adicionar esses campos na exibio do arquivo Ar.
Captulo 4
Comandos
259
Agora voc pode utilizar o campo Cdigo do vendedor para relacionar o arquivo Ar ao
arquivo Sales Rep e adicionar o campo Nome do vendedor exibio do arquivo Ar.
Agora todos os campos de interesse esto na exibio do arquivo pai Ar e podem ser
analisados como se estivessem no prprio arquivo.
Nota: Voc pode trabalhar com campos a partir dos arquivos relacionados, estejam eles
adicionados ou no exibio do arquivo pai. Depois que os relacionamentos so estabelecidos, todos os campos relacionados ficam disponveis para anlise, a partir do arquivo
pai e aparecem nas listas de seleo de campos nos comandos e no Construtor de
expresses.
Parmetros
Alm dos parmetros descritos a seguir, o comando Relations (Relacionamentos) tem o
seguinte parmetro: As (Como). Para obter uma descrio, consulte o Captulo 3:
Definir arquivos e campos.
Delete Relationship (Excluir relacionamento)

Permite que voc exclua qualquer relacionamento, contanto que no tenha relacionamentos dependentes e nenhum campo relacionado na exibio atual ou em um campo
calculado ativo.
Clique neste boto para remover o relacionamento selecionado. O ACL pergunta se voc
tem certeza de que deseja excluir este relacionamento. Clique em [Sim] ou [No].
OK
O ACL executa o comando sem solicitao. Caso contrrio, o ACL solicita que voc
aceite ou cancele a excluso do relacionamento especificado.
Parent File (Arquivo pai)

O arquivo aberto atualmente. O ACL exibe o nome do arquivo pai. Para escolher um
arquivo pai diferente, feche a caixa de dilogo Relacionamentos, abra o novo arquivo,
selecione Dados, na barra de menu e escolha Relacionamentos.
Relate On (Relacionado por)

Permite que voc selecione o campo ou expresso-chave a partir do arquivo pai, para
relacionar. S permitido selecionar um campo para cada relacionamento.
Selecione um campo a partir da caixa de listagem Relacionado com ou clique em
[Relacionado por] para exibir a caixa de dilogo Selecionar campos. A partir deste
ponto voc pode escolher um campo da caixa de listagem Campos disponveis ou
acessar o Construtor de expresses para selecionar um campo e aplicar condies a ele.
260

Manual de Referncia
Related File (Arquivo relacionado)

Permite a voc selecionar o arquivo filho. Esta lista suspensa exibe todos os arquivos
disponveis em seu Projeto ACL, exceto o arquivo pai e arquivos j relacionados.
Selecione o arquivo relacionado (filho) na lista suspensa.
Relation Name (Nome do relacionamento)

Permite criar mais de um relacionamento no mesmo arquivo, quando voc especificar
um novo nome na caixa de texto Nome do relacionamento. Como padro, a caixa de
texto Nome do relacionamento exibe o nome da definio de arquivo de entrada relacionado. Mas voc pode digitar um nome diferente e exclusivo e, em seguida, criar um
segundo relacionamento entre os mesmos arquivos, utilizando um campo-chave
diferente.
Por exemplo, voc relacionou um nome de arquivo Ar com um campo-chave Cdigo do
Cliente. O ACL exibe o nome do arquivo relacionado, nesse caso Customer, na caixa
de texto Nome do relacionamento. Como a relao existente em Customer j utiliza o
nome da definio de arquivo de entrada relacionado, voc deve fornecer um nome
novo e exclusivo. Faa a indexao do arquivo Customer em um novo campo-chave.
Depois, para criar um novo relacionamento de Ar com Customer, digite um nome
como Customer_2 na caixa de texto Nome do relacionamento, selecione o ndice da
lista suspensa Usando ndice e clique em [Relacionar].
Pai
Filho
Campo-chave
Nome do
Relacionamento
Ar
Customer
Cdigo do Cliente
Customer
Ar
Customer
Novo campo-chave
Customer 2
Relationships (Relacionamentos)
Exibe detalhes dos relacionamentos referentes ao arquivo aberto. Por exemplo, a caixa
de listagem Relacionamentos acima mostra que no existem relacionamentos. Os
detalhes dos relacionamentos do arquivo aberto so organizados para mostrar nome
do arquivo relacionado relacionado ao nome do campo, utilizando o ndice nome
do arquivo ndice. Esses detalhes indicam a origem de todos os campos.
Using Index (Usando ndice)

Permite selecionar um ndice para o campo-chave do arquivo filho. Selecione um ndice
na caixa de listagem.
Captulo 4
Comandos
261
Caixa de dilogo Relacionamentos

Clique em
(Relacionamentos) na barra de botes ou selecione Dados, na barra de
menus e escolha Relacionamentos para exibir a caixa de dilogo Relacionamentos.
Relacionamento de arquivos
Para relacionar dois arquivos:
1. Abra o arquivo Ar clicando duas vezes no nome do arquivo na janela Viso geral ou
arrastando-o da janela Viso geral para a rea de trabalho do aplicativo.
Clique duas vezes ou

clique e arraste
262

Manual de Referncia
2. Clique em [Relacionamentos], na barra de botes ou selecione Dados na barra de

menus e escolha Relacionamentos para exibir a caixa de dilogo Relacionamentos.
3. Selecione o campo denominado No como o campo-chave da caixa de listagem
Relacionado por. Ou, clique em [Relacionado por] para exibir a caixa de listagem
Campos selecionados, que fornece mais informaes sobre os campos que voc est
selecionando.
Existem trs maneiras para selecionar os campos utilizando a caixa de dilogo

Campos selecionados:
Clique no nome do campo para selecion-lo e, em seguida, utilize a

(seta) para mover-se entre as caixas de lista.
Clique duas vezes no nome do campo para selecion-lo e mova-o da caixa de
listagem Campos disponveis para a caixa de listagem Campos selecionados.
Clique em [Expr] para exibir o Construtor de expresses. Ele permite que voc
aplique uma condio ou filtro aos dados do campo selecionado.
Selecione o campo desejado, a partir da caixa de listagem Campos disponveis e, em

seguida, clique em [OK] para voltar caixa de dilogo Relacionamentos.
4. Clique na lista suspensa Arquivo relacionado e selecione o arquivo denominado
Customer. Depois de selecionar o arquivo Customer, a caixa de listagem Usando
ndice exibe os nomes dos ndices para aquele arquivo.
5. Na caixa de listagem Usando ndice, selecione Customer_index.
Captulo 4
Comandos
263
6. Clique em [Relacionar] para visualizar os detalhes do relacionamento, na caixa de

listagem Relacionamentos. A caixa de dilogo permanece aberta at voc clicar em
[Concludo], permitindo estabelecer relacionamentos mltiplos.
7. Clique em [Concludo] para fechar a caixa de dilogo Relacionamentos.
Acessar campos relacionados

Depois de estabelecer relacionamentos, voc pode acessar os campos a partir dos
arquivos filhos, por meio da exibio, das caixas de dilogo e pelo Construtor de
expresses.
264

Manual de Referncia
Para acessar por meio da exibio

Adicione os campos do arquivo filho na exibio utilizando o boto Adicionar Colunas,
na barra de botes na janela Exibio. Consulte Adicionar campos exibio na
pgina 265.
Para acessar por meio das caixas de dilogo de comando

Este exemplo mostra o comando Ordenar, mas voc pode acessar os campos da mesma
forma com qualquer comando que contenha uma caixa de listagem Campos disponveis.
1. Selecione Dados na barra de menus e escolha Ordenar ou clique em [Ordenar], na
barra de botes, para exibir a caixa de dilogo Ordenar.
2. Clique em [Ordenar em] para exibir a caixa de dilogo Campos selecionados:
3. Da lista suspensa A partir do arquivo de entrada, selecione um arquivo filho para
exibir uma lista de todos os campos do arquivo escolhido, na caixa de listagem
Campos disponveis. Os campos so exibidos no formato nome-de-relacionamento.nome-de-campo, para mostrar a partir de qual definio de arquivo de
entrada procedem os campos.
4. Na caixa de listagem Campos disponveis, clique duas vezes no campo que deseja
ordenar e, em seguida, clique na seta direita para mover o campo para a caixa de
listagem Campos selecionados.
5. Clique em [OK] para voltar caixa de dilogo Ordenar, na qual voc pode executar
o comando de maneira normal. Para obter mais informaes, consulte Sort
(Ordenar) na pgina 317.
Captulo 4
Comandos
265
Para acessar por meio do construtor de expresses

1. Clique em
(Editar filtro de exibio), na barra de botes da janela Exibio, para
exibir a caixa de dilogo Editar filtro de exibio comumente chamada Construtor
de expresses.
2. Selecione um arquivo filho da lista suspensa A partir do arquivo de entrada para

exibir uma lista de todos os campos do arquivo filho na caixa de listagem Campos
disponveis. Os campos so exibidos novamente no formato
nome-de-arquivo.nome-de-campo, da mesma forma na qual voc acessa por meio
da caixa de dilogo de comando. Agora possvel criar expresses da maneira
normal, utilizando campos do arquivo filho.
Adicionar campos exibio

Para adicionar campos a partir do arquivo Customer exibio do arquivo Ar:
1. Clique em
(Adicionar colunas), na barra de botes da janela Exibio, para
exibir a caixa de dilogo Adicionar colunas.
2. Selecione Customer na lista suspensa A partir do arquivo de entrada, para exibir os
campos do arquivo relacionado. O formato nome-de-relacionamento.nome-de-campo indica a origem dos campos.
266

Manual de Referncia
3. Mova os campos que deseja adicionar exibio, a partir da caixa de listagem

Campos disponveis para a caixa de listagem Campos selecionados, clicando duas
vezes em um campo, ou selecionando um campo e clicando na tecla de seta.
4. Na caixa de listagem Campos disponveis, clique duas vezes no campo que deseja
ordenar, ou selecione o campo e, em seguida, clique na seta direita para mover o
campo para a caixa de listagem Campos selecionados.
5. Clique em [OK] para voltar exibio. O ACL adiciona os campos selecionados
exibio do arquivo Ar. Voc pode analisar simultaneamente dados de ambos os
arquivos.
Campos do arquivo primrio
Campos do arquivo relacionado
Excluir relacionamentos
Voc pode excluir qualquer relacionamento que no tenha relacionamentos dependentes, e nenhum campo relacionado na exibio atual ou em um campo calculado
ativo.
Captulo 4
Comandos
267
Exemplo
1. Abra a exibio padro do arquivo do qual voc deseja excluir o relacionamento.
Selecione Dados na barra de menus e escolha Relacionamentos para exibir a caixa
de dilogo Relacionamentos.
2. A partir da caixa de listagem Relacionamentos, selecione o relacionamento que

deseja excluir.
3. Clique em [Excluir relacionamento].
4. O ACL pergunta se tem certeza de que deseja excluir este relacionamento. Clique em
[Sim] para confirmar a excluso. A caixa de texto Relacionamentos confirma a
excluso.

No modo de comando voc pode utilizar os comandos Define (Definir), Delete
(Excluir) e Display (Exibir) para trabalhar com relacionamentos. Alm disso, pode
utilizar um parmetro do comando Open (Abrir) para definir um relacionamento
temporrio.
268

Manual de Referncia
Define (Definir)
Esta a verso do modo de comando do comando Relacionamentos, na barra de menus.
Ela permite criar um relacionamento entre um arquivo pai e um filho por um
campo-chave comum, utilizando um ndice especificado para o arquivo filho.
DEFINE RELATION nome-do-campo-chave WITH
nome-do-arquivo-relacionado INDEX nome-do-ndice <AS
nome-do-relacionamento>
nome-do-relacionamento permite especificar um novo nome do relacionamento
para poder criar um outro relacionamento com o mesmo arquivo.
Delete (Excluir)
Este comando permite excluir qualquer relacionamento que no tenha relacionamentos
dependentes e nenhum campo relacionado na exibio atual ou em um campo
calculado ativo.
DELETE RELATION
Voc pode incluir essas opes no formato de sintaxe:

<dae-relacionada/nome-do-relacionamento>
<OK>
<dae-relacionada/nome-do-relacionamento> especifica quais relacionamentos sero excludos. Se voc no incluir este qualificador, o ACL excluir o ltimo
relacionamento definido.
Consulte Delete (Excluir) na pgina 149 para obter detalhes.
Display (Exibir)
Este comando permite visualizar os detalhes dos relacionamentos do arquivo atual, da
mesma forma que voc visualizaria na caixa de listagem Relacionamentos, da caixa de
dilogo Relacionamentos. O ACL utiliza o formato nome-do-arquivo-relacionado relacionado por nome-do-campo-chave utilizando o ndice chamado nome-do-ndice.
DISPLAY RELATION
Por exemplo:
Customer relacionado por No utilizando ndice Customer_index.
Definir relacionamentos temporrios

Voc tambm pode utilizar o comando Open (Abrir) para abrir um arquivo relacionado
e definir um relacionamento temporrio para ele. Em outras palavras, o arquivo filho
torna-se temporariamente um arquivo pai. Primeiro, abra o arquivo pai. Em seguida,
Captulo 4
Comandos
Rename (Renomear)
269
abra o arquivo relacionado, utilizando o parmetro RELATION no comando Open

(Abrir):
OPEN nome-arquivo-relacionado INDEX nome-do-ndice RELATION
nome-do-campo-relacionado-do-arquivo-primrio
Como este um relacionamento temporrio, ele deixa de existir quando voc fecha
qualquer um dos arquivos. Alm disso, no se pode utilizar o comando Display Relation
(Exibir relacionamentos) para visualizar os detalhes dos relacionamentos temporrios
assim criados. O comando Display Relation exibe apenas os detalhes dos relacionamentos permanentes.
DISPLAY RELATION
Nenhum arquivo relacionado definido no momento.

Em vez disso, utilize o comando Display (Exibir) no arquivo pai:
DISPLAY OPEN
A definio de relacionamentos temporrios muito til no modo batch, no qual

possvel utilizar o comando Open (Abrir) para abrir e definir um relacionamento com
um comando.
Rename (Renomear)
Use o comando Renomear para alterar o nome de um campo, arquivo ou objeto contido
no Projeto ACL.
ACL para Windows.
Voc pode rapidamente renomear quaisquer itens que compem um Projeto ACL (por
exemplo, um arquivo de entrada ou um batch) selecionando o nome do item na janela
Viso geral e clicando em
(Renomear).
Para usar o comando Renomear para renomear um dos itens que compem um Projeto
ACL, necessrio especificar o parmetro apropriado (por exemplo, BATCH) no
comando. Consulte a segunda variao da sintaxe do comando Renomear, a seguir.
Voc no pode renomear um campo que esteja includo na exibio atual ou na
definio de um campo calculado. Tambm no possvel renomear um arquivo de
entrada que esteja atualmente em uso.
Voc tambm pode renomear campos utilizando a janela Definio de arquivo de
entrada, conforme descrito em Manteno das Definies dos arquivos de entrada na
270

Rename (Renomear)
Manual de Referncia
pgina 184 do Guia do Usurio do ACL para Windows. Tambm possvel renomear
arquivos de entrada na caixa de dilogo Selecionar arquivo de entrada, conforme
descrito em Caixas de dilogo selecionar/editar na pgina 40 do Guia do Usurio do
ACL para Windows. A renomeao feita atravs da caixa de dilogo Selecionar arquivo
de entrada renomeia a definio de arquivo de entrada, mas no o arquivo de dados ao
qual est vinculado.
Pr-requisitos
Os campos a serem renomeados no podem estar includos na exibio atual nem ser
referenciados por uma definio de campo calculado.
Os arquivos que sero renomeados no podem estar abertos e o novo nome no pode
ser igual ao nome do arquivo existente.
Os arquivos a serem renomeados no podem estar abertos.
Parmetros
Alm dos parmetros descritos a seguir, o comando Rename (Renomear) tem os
seguintes parmetros: As (Como), File (Arquivo), To (Para). Para obter uma descrio,
consulte o Captulo 3: Definir arquivos e campos.
Batch, Format (Formato), Index (ndice), Report (Relatrio), Workspace (rea de trabalho)
Especificam o tipo de item a ser renomeado.
Data (Dados), Log, Text (Texto)

Especificam o tipo de arquivo a ser renomeado. Isso implica uma extenso de arquivo
apropriada (por exemplo, Data.fil, Log.log, Text.txt).
Field (Campo)
Permite renomear um campo.
OK
Indica que o processo de renomeao pode prosseguir sem confirmao.

RENAME <FIELD>{nome-antigo-do-campo|nome-antigo-da-varivel}
RENAME {BATCH|FORMAT|INDEX|REPORT|WORKSPACE}
nome-antigo-do-item
RENAME <DATA|FILE|LOG|TEXT|nome-antigo-do-arquivo>
<AS|TO> novo-nome
<OK>
Captulo 4
Comandos
Rename (Renomear)
271
Exemplo 1
Sempre que possvel, um nome de campo deve descrever seu contedo. Se um campo
no tiver sido nomeado apropriadamente, voc pode usar Rename (Renomear) para
alterar o nome.
Em um arquivo de transaes de vendas, para renomear o campo do nmero da fatura
de ProdNo para Product, use o comando Rename. Certifique-se de que Comandos
esteja selecionado na caixa de listagem suspensa do Log do comando e digite o seguinte:
RENAME FIELD PRODNO AS PRODUCT
Voc ser solicitado a confirmar se est seguro de que deseja renomear o campo.
Clique em [OK] para renomear o campo.

A janela Definio de arquivo de entrada agora mostra o campo renomeado. O novo
nome Product aparece em vez de ProdNo.
272

Report (Relatrio)
Manual de Referncia
Exemplo 2
Para renomear um batch Ar June sem solicitao de confirmao, digite RENAME
BATCH ARJUN TO AR06 OK na caixa de texto do Log de comando.
Report (Relatrio)
Use o comando Relatrio para imprimir um relatrio e para especificar opes de
impresso. Voc tambm pode especificar um arquivo HTML (HyperText Markup
Language) como a sada do relatrio. Todos os navegadores da Web podem ler arquivos
no formato HTML. Isso permite que voc prepare os relatrios ACL para serem distribudos ou publicados na World Wide Web. O ACL gera arquivos HTML no formato
HTML 3,0.
Nota: Como a maioria das sadas dos relatrios do ACL est no formato de tabela, para
visualizar os dados de sada necessrio um navegador da Web que suporte tabelas, como
o Netscape 3 ou mais recente, Internet Explorer 3 ou mais recente.
Um relatrio baseado em uma exibio. Opcionalmente, voc pode usar a verso de
linha de comando para formatar um relatrio. A linha de comando no tem acesso a
certos recursos avanados, como fontes.
H trs passos bsicos para criar um relatrio formatado:
1. Abrir uma exibio e especificar a formatao de campos que se deseja para o
relatrio.
2. Abrir a caixa de dilogo Relatrio e especificar o layout da pgina e do relatrio.
3. Imprimir o relatrio.
Utilize as opes disponveis na caixa de dilogo Relatrio para o segundo e terceiro
passos da criao de um relatrio. Voc pode especificar um cabealho e um rodap,
ordenar seu relatrio com base em campos-chave previamente selecionados, produzir
um relatrio sumarizado, ignorando detalhes, e especificar o espaamento entre linhas
e o tamanho da fonte. Voc pode ainda acessar a caixa de dilogo Configurar impresso
do Windows, e escolher entre enviar seu relatrio para a tela, para um arquivo, visualizar a impresso do relatrio ou enviar o relatrio diretamente para a impressora.
Personalizar relatrios
A criao de um relatrio est descrita com detalhes em Imprimir no ACL na
pgina 50 do Guia do Usurio do ACL para Windows. Recomendamos que voc leia o
contedo desta seo antes de usar o comando Relatrio.
Captulo 4
Comandos
Report (Relatrio)
273
Pr-requisitos
necessrio abrir uma exibio antes de selecionar Dados na barra de menu e escolher
Relatrio. A exibio usada para formatar os campos e determinar o layout e o
contedo do relatrio.
Parmetros
Alm dos parmetros descritos a seguir, o comando Report (Relatrio) tem os seguintes
parmetros: Append (Anexar a um arquivo existente), End Of File (Fim do arquivo),
File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Nodups (Suprimir duplicidades),
Nozeros (Branco se for zero), Print (Imprimir), Screen (Tela), Suppress (Suprimir
outros), While (Enquanto). Para obter a descrio desses parmetros, consulte o
Detail Line Spacing (Espaamento da linha de detalhe)

Permite que voc especifique o nmero de espaos entre as linhas de detalhe do
relatrio. Selecione espaamento simples, duplo ou triplo da lista suspensa.
Essas opes no se aplicam a um relatrio sumarizado.
Padro: Espaamento simples.
Faz com que o ACL indexe os campos-chave selecionados, antes de criar um relatrio.
Para selecionar esta opo, voc precisa primeiro selecionar os campos-chave na
exibio, usando o marcador de campo-chave para ordenao. Voc tambm precisa
especificar a seqncia de ordenao para cada campo-chave.
Consulte Imprimir no ACL na pgina 50 do Guia do Usurio do ACL para Windows,
para obter detalhes.
Preview (Visualizar)
Permite visualizar o formato de seu relatrio com a orientao e o tamanho de pgina
que voc especificou na caixa de dilogo Configurar pgina.
Para visualizar a pgina seguinte ou a anterior, clique em [Prximo] ou [Anterior],
respectivamente.
Para ampliar uma rea do seu relatrio, posicione seu cursor sobre a rea da pgina a ser
ampliada e clique. Clique na pgina para diminuir o zoom e visualizar a pgina inteira
novamente.
274

Report (Relatrio)
Manual de Referncia
Para pular para a ltima pgina de seu relatrio, clique em [ltima pgina].
Setup (Configurar)
Exibe a caixa de dilogo Configurar pgina se voc selecionou a impressora como sada.
Voc pode selecionar uma impressora, o tamanho e orientao do papel e especificar
vrias outras opes que afetam a forma como seu relatrio impresso.
Summarize (Sumarizar)
Produz um relatrio somente com subtotais e totais, sem linhas de detalhe. Os subtotais
so gerados com base nos campos-chave de quebra selecionados na exibio.
Se esta opo no for selecionada, o ACL produzir um relatrio que inclui linhas de
detalhe, bem como subtotais para cada um dos campos-chave de quebra especificados.
Padro: Incluir linhas de detalhe.
Suppress Blank Detail Lines (Suprimir linhas de detalhes em branco)

No exibe linhas de detalhe em branco. O relatrio mover automaticamente os dados
para cima para preencher o espao em branco das linhas de detalhe. Isso reduz
espaos em branco desnecessrios em seus relatrios e torna o relatrio e os dados mais
fceis de ler. Consulte Suprimir linhas de detalhe em branco na pgina 222 do
Guia do Usurio do ACL para Windows para obter mais detalhes.
Caixa de dilogo Relatrio

Clique em
(Relatrio) ou selecione Dados na barra de menus e escolha Relatrio
para exibir a caixa de dilogo Relatrio.
Captulo 4
Comandos
Report (Relatrio)
275
Exemplo 1
Neste exemplo, voc prepara um relatrio.
Aps formatar o contedo do seu relatrio na exibio, use a caixa de dilogo Relatrio
para especificar um cabealho e um rodap, um espaamento entre linhas e todos os
parmetros de configurao da impressora.
Selecione um cabealho e um rodap que descrevam adequadamente o contedo e o
autor do relatrio. Para produzir um relatrio detalhado com espaamento duplo,
selecione Espaamento duplo da lista suspensa.
276

Report (Relatrio)
Manual de Referncia
Quando voc estiver satisfeito com todas as opes de impresso e especificaes do

relatrio, clique em [OK] para exibir a caixa de dilogo Imprimir, onde possvel
escolher as pginas a serem impressas. Em seguida, verifique novamente as opes de
impresso e clique em [Imprimir] para imprimir o relatrio.
Exemplo 2
Neste exemplo, voc cria um relatrio de linhas mltiplas. Como um relatrio baseado
em uma exibio, voc pode usar o recurso de linhas mltiplas do ACL para reorganizar
sua exibio atual, de modo a aproxim-la do formato de seu relatrio final. Consulte
Criar exibies com multilinhas na pgina 208 do Guia do Usurio do
Captulo 4
Comandos
Report (Relatrio)
277

REPORT <ON> campo-chave <NODUPS>
<PAGE> ...
{FIELDS|ACCUMULATE} outros-campos <SUPRESS><NOZEROS>...
<LINE n outros-campos>
<SUMMARIZED>
<TO nome-do-arquivo-a-ser-criado> <HTML>
<HEADER cabealho>
<FOOTER rodap>
<SKIP n>
<APPEND>
<EOF>
Nota: Para usar <NODUPS>, <ON> tambm deve ser includo, conforme exibido.
<NODUPS> no funcionar se <ON> no for especificado.
LINE n especifica as linhas de sada adicionais. n pode ser um valor entre 2 e 60. Os
campos que aparecem na linha n devem seguir n.

Os ttulos de coluna do relatrio so determinados unicamente pelos campos na
primeira linha.
outros-campos especifica os campos ou expresses apropriadas para o relatrio.
278

Sample (Amostra)
Manual de Referncia
Sample (Amostra)
Utilize o comando Amostra para criar uma amostra de registros ou unidades
monetrias (MUS) de uma populao, em um arquivo de entrada.
O comando Amostra suporta uma vasta gama de atividades de amostragem. Voc pode
criar amostras de registros ou monetrias em combinao com um nmero de
parmetros e opes de amostra, para atender suas necessidades.
Nota: A criao de uma sada de registro a partir de um arquivo que contm campos
estticos e/ou estticos condicionais pode produzir resultados imprevisveis. Certifique-se
de selecionar apenas os campos desejados.
Nota: Ao processar arquivos do servidor que contenham arquivos selecionados, a sada do
registro ser alterada para todos os campos, se voc especificar a opo ou palavra-chave
local.
O comando Amostra oferece os seguintes tipos de amostragem:
Amostragem aleatria
Amostragem de intervalo
Seleo de intervalo fixo aps incio aleatrio
Amostragem de clula (seleo aleatria em cada intervalo)
Amostragem condicional com clusulas Se, Enquanto, Prximos e Primeiros
A abordagem da amostragem escolhida depende de sua avaliao das caractersticas da

populao da qual deseja obter a amostragem, bem como de suas necessidades e preferncias.
Ao escolher uma abordagem para a amostragem, til saber como a tendncia de
amostragem e o mtodo de seleo afetam os resultados de cada opo de amostragem
do ACL.
Tendncia de amostragem
Tendncia de amostragem a probabilidade de seleo atribuda a cada item da
populao. A tendncia varia de acordo com o mtodo de amostragem utilizado.
Amostragem de registros
Uma amostra de registros no tem tendncia. Todos os registros do arquivo tm as
mesmas chances de serem selecionados. Um item de cem dlares tem as mesmas
chances de ser selecionado que um item de um milho de dlares. Portanto, h uma
Captulo 4
Comandos
Sample (Amostra)
279
probabilidade considervel de que as transaes muito grandes sejam analisadas muito

superficialmente.
A amostragem de registros mais til para testes de concordncia ou subavaliao.
No teste de concordncia, voc se preocupa mais com a taxa de erros na populao total.
As grandes transaes devem ser submetidas a controles extras, ausentes para pequenas
quantidades. Se voc escolher um mtodo de amostragem voltado para grandes quantidades, evitar um problema em potencial com relao s pequenas transaes.
Nos testes de subavaliao, voc se preocupa mais com os itens que esto faltando ou
que esto registrados em um valor muito pequeno. Isso pode acontecer porque as
quantidades maiores tm menos probabilidade de serem subavaliadas.
Amostragem de unidade monetria

Uma amostragem de unidade monetria apresenta tendncia de itens com valor mais
alto. Um item de um milho de dlares tem mais probabilidade de ser selecionado do
que um item de cem dlares. A chance de um item ser selecionado diretamente
proporcional a seu tamanho.
As amostras por unidade monetria so teis para testes de valor ou de superavaliao.
Com a tendncia voltada para itens de maior valor, uma amostra MUS oferece um alto
nvel de segurana no sentido de que todos os itens significativos na populao estejam
sujeitos ao teste. Durante o teste de superavaliao, so os itens de alto valor que
apresentam o maior risco de conter erros significativos. A populao de uma unidade
monetria (MUS) o valor absoluto do campo que est sendo amostrado. Os campos
podem conter tanto nmeros negativos quanto positivos e os nmeros negativos no
podem resultar em superavaliao.
Limite
Voc pode tambm tendenciar a amostra, incluindo ou excluindo classes inteiras de
transaes ou registros. Voc pode usar Limite para incluir especificamente todas as
transaes acima de um determinado valor. Voc tambm pode especificar uma
condio para uma faixa ampla de testes; por exemplo, excluindo itens da Classe de
Produto 05, ou incluindo somente valores acima de $10.000 para o ms de abril.
Tipo de amostra
Ao selecionar um tipo de amostra, voc est determinando o mtodo especfico a ser
usado para criar a amostra. O comando Amostra oferece os trs mtodos bsicos a
seguir:
Amostragem por intervalo fixo
Amostragem por clula
280

Sample (Amostra)
Manual de Referncia
Amostragem aleatria
Voc pode usar quaisquer outros mtodos por meio de lgica programada, em um
grupo de comandos. Para obter mais informaes, consulte Em batches e grupos na
Amostragem por intervalo fixo

Em uma amostra por intervalo fixo necessrio especificar um valor do intervalo e um
nmero inicial aleatrio. Se voc especificar um incio aleatrio de 611 e um intervalo
de 900, o ACL selecionar o 611 item e, a partir da, todo o 900 item. Como um item
normalmente um registro ou uma unidade monetria, o 611 item pode ser o registro
611 ou o 611 unidade monetria da populao.
Quando voc aplica o mtodo de intervalo fixo a uma amostragem monetria, est
selecionando unidades monetrias individuais a partir da populao. Entretanto, um
item de mil reais contm 1.000 reais individuais e um item de um milho de reais
contm 1.000.000 de reais individuais e qualquer um deles pode ser selecionado. Depois
que o real individual selecionado, o registro que contm este real retirado.
Nota: Voc deve escolher a amostragem de intervalo fixo se pretende usar o comando
Avaliar para avaliar erros. Os tamanhos de amostra determinados pelo comando Tamanho
tambm so designados para uso com amostragem de intervalo fixo.
Amostragem por clula

Em uma amostragem por clula, a populao dividida em grupos do tamanho do
intervalo. Um item aleatrio escolhido a partir de cada grupo. O ACL gera automaticamente os nmeros aleatrios necessrios, com base na origem aleatria que voc
especificou.
Quando voc aplica a amostragem por clula a uma amostra monetria, possvel que
o mesmo registro seja selecionado duas vezes. Isso pode ocorrer se um registro ultrapassar o limite entre dois intervalos. O nmero aleatrio gerado para o primeiro
intervalo alto e o nmero aleatrio gerado para o segundo intervalo baixo. Dependendo da natureza das transaes, a seleo do mesmo item duas vezes pode resultar em
uma subamostragem.
Amostragem aleatria
Na amostragem aleatria, voc precisa especificar um valor de origem aleatrio, o
tamanho da populao e o nmero de selees exigidas. O ACL gera a quantidade
exigida de nmeros aleatrios entre um e a populao especificada, com base na origem
aleatria e, em seguida, faz selees usando os nmeros aleatrios.
Captulo 4
Comandos
Sample (Amostra)
281
Uma amostra aleatria pode extrair bem poucas amostras de certos segmentos da
populao. A menos que voc adote procedimentos especficos, as transaes significativas podem ser completamente ignoradas.
Se voc marcar a caixa de seleo Sem repeties para limitar as retiradas sucessivas,
uma amostragem aleatria poder produzir menos selees do que foi solicitado. Em
uma amostragem monetria aleatria, se dois dos nmeros aleatrios gerados forem
prximos, podem tornar-se parte do mesmo registro. Se isso ocorrer, o ACL no ir
selecionar outro item. Para obter mais informaes, consulte Amostragem com e sem
substituio na pgina 390 do Guia do Usurio do ACL para Windows.
Ao executar uma amostra aleatria, voc pode pedir a ordem de seleo dos itens
extrados. Isso til quando voc faz uma superamostragem. Voc s pode solicitar a
ordem de seleo quando faz amostragem aleatria e seleciona a sada de campos, no
do registro inteiro.
Na rea Tipo de amostra da caixa de dilogo, selecione Registro. Na rea Parmetros da
amostra, selecione Aleatrio e digite os valores do Tamanho (da superamostra), da
Origem e da Populao. Na caixa de texto Para, informe o nome do arquivo de sada.
Clique em [Mais].
Na rea de Sada da guia [Mais], selecione Campos e, em seguida, selecione os campos

que deseja em seu arquivo de sada. A caixa de seleo Ordem de seleo de relatrio s
estar disponvel se sua escolha de sada for Campos. Para obter o nmero da ordem de
seleo dos itens amostrados, marque a caixa de seleo Ordem de seleo de relatrio.
Clique em [OK].
282

Sample (Amostra)
Manual de Referncia
A exibio de seu arquivo de sada contm um campo entitulado ORDER, a ltima

coluna direita. Esta coluna exibe a ordem dos registros selecionados. Voc pode ento
selecionar o primeiro nmero x de itens e, se necessrio, voltar e selecionar os prximos
x itens. Para facilitar o uso, voc pode ordenar arquivo de sada pela coluna ORDER,
para visualizar a ordem de seleo.
Captulo 4
Comandos
Sample (Amostra)
283
No exemplo acima, o registro 1 o primeiro item selecionado e o registro 10 o segundo

item selecionado, e assim por diante.
Nota: importante que voc consiga re-extrair as amostras j produzidas, se necessrio.
Por exemplo, se quatorze itens de 750.000 foram selecionados, voc deve ser capaz de
selecionar os mesmos quatorze itens. Por esse motivo, tanto a amostragem de clula, como
a aleatria iro produzir os mesmos resultados, dado o mesmo arquivo e origem aleatria.
Se voc define a origem em 0, o ACL ignora o 0 e usa um nmero aleatrio. O uso de uma
origem aleatria (origem = 0) no produzir os mesmos resultados, mas como o ACL relata
o nmero gerado em resposta a um zero, at mesmo essas amostras podem ser reproduzidas
fornecendo-se uma origem igual ao nmero gerado pelo ACL.
Para obter mais informaes, consulte o Captulo 10: Amostragem com o ACL no
Guia do Usurio do ACL para Windows Verso 7.
Parmetros
Alm dos parmetros descritos a seguir, o comando Sample (Amostra) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), First (Primeiros),
Footer (Rodap), Header (Cabealho), If (Se), Next (Prximos), Record (Registro), To
(Para), While (Enquanto). Para obter uma descrio desses parmetros, consulte
Cell (Clula)
Seleciona Clula como o mtodo de amostragem.
Cutoff (Limite)
Especifica uma quantidade para amostragem de Intervalo Fixo e de Clula, acima da
qual um item considerado da camada superior. Os itens de camada superior so
exibidos automaticamente e includos na amostra.
O limite padro o tamanho do intervalo.
Extract Fields (Extrair campos)

Permite que voc selecione os campos ou expresses a serem includos juntamente com
o registro de sada amostrado. Pode ser usado qualquer campo ou expresso. Para
acessar esta opo, selecione o boto de seleo Campos; em seguida selecione os
campos na caixa de listagem ou clique em [Extrair campos] para abrir a caixa de dilogo
Campos selecionados.
Para obter mais informaes sobre a caixa de Campos Selecionados, consulte Caixas de
284

Sample (Amostra)
Manual de Referncia
Consulte tambm Construtor de expresses na pgina 275 do Guia do Usurio do

ACL para Windows.
Fields (Campos)
Permite que voc selecione campos especficos a serem includos no arquivo de sada,
ativando a caixa de listagem Extrair campos.
Fixed Interval (Intervalo fixo)

Seleciona Intervalo fixo como mtodo de amostragem.
Interval (Intervalo)
Especifica o valor do intervalo para amostragem de Intervalo fixo e Clula.
MUS
Seleciona a amostragem por unidade monetria como o tipo de amostra.
No Repeats (Sem repeties)

Instrui o ACL a no selecionar o mesmo registro ou valor de unidade monetria (MUS)
mais de uma vez. Como o ACL no substitui nenhuma seleo omitida, podero ser
exibidos menos registros ou valores que o esperado.
O padro repetir.
Population (Populao)
Permite especificar o nmero total de unidades na populao, seja em termos de
registros ou valor absoluto do campo que est sendo amostrado. O valor de uma
populao est somente disponvel para Amostragem aleatria.
Para assegurar-se de que todos os registros ou valores de campo na populao de
amostragem tm igual oportunidade de seleo, use o nmero total de registros no
arquivo ou o valor absoluto do campo usado como amostra, conforme apropriado,
como tamanho da populao.
Se voc escolher algum outro tamanho para a populao, o ACL ir inform-lo na janela
Log de comando que o total da populao fornecida difere do total real.
O padro da amostragem MUS o valor absoluto do campo, se os comandos Perfil ou
Estatsticas foram emitidos anteriormente. Do contrrio, no h padro.
O padro para amostragem de Registros a contagem de registros do arquivo.
Captulo 4
Comandos
Sample (Amostra)
285
Random (Aleatrio)
Seleciona Aleatrio como o mtodo de amostragem. O ACL oferece diferentes
parmetros de amostragem, dependendo de voc ter escolhido os botes de opo
Intervalo fixo, Clula ou Aleatrio.
Record (Registro)
Na guia [Principal]. Seleciona a amostragem por Registro como o tipo de amostra.
Report Selection Order (Ordem de seleo de relatrio)

Faz com que a ordem de seleo seja enviada para a sada como um campo. Consulte a
seo sobre Amostragem aleatria, apresentada anteriormente.
Sample On (Amostra em)

Especifica o campo ou expresso referente amostragem por unidade monetria
(MUS). Selecione o campo na lista suspensa ou clique em [Amostra em] para abrir a
Para obter mais informaes sobre a caixa de Campos selecionados, consulte Caixas de
Consulte tambm Construtor de expresses na pgina 275 do Guia do Usurio do
ACL para Windows.
Nota: As opes variam de acordo com o mtodo de amostragem escolhido.
Seed (Origem)
Especifica o valor de origem para o gerador de nmeros aleatrios das amostras Clula
e Aleatrio.
Size (Tamanho)
Exibe a caixa de dilogo Tamanho, que voc pode usar para determinar tamanhos
apropriados de amostra para usar com registros e MUS. Informe os valores de
parmetro apropriados e clique em [Calcular] para exibir os resultados. Clique em [OK]
para voltar caixa de dilogo Amostra. Todos os parmetros que voc atribuiu na caixa
de dilogo Tamanho so mantidos.
Consulte Size (Tamanho) na pgina 309 para obter detalhes sobre o uso do comando
Tamanho.
Start (Incio)
Especifica o primeiro registro ou unidade monetria escolhida em uma amostra de
Intervalo fixo.
286

Sample (Amostra)
Manual de Referncia
Subsample (Subamostra)
Gera um campo adicional no arquivo de sada, que contm um nmero aleatrio entre
zero e o valor de campo do item selecionado. Isso til quando for necessria uma
subamostragem (por exemplo, onde um item de amostra selecionado composto de
vrios itens menores). Os itens de camada superior tm um valor de Subamostra igual
a zero, facilitando procedimentos de auditoria alternativos nessa populao.
Isso s estar disponvel se voc selecionar sada de campos.
O padro sem subamostragem.
Caixa de dilogo Amostra

Clique em
(Amostra) ou selecione Amostra na barra de menus para exibir a caixa
de dilogo Amostra.
Exemplo 1
Neste exemplo, voc cria uma amostra de unidade monetria (MUS) de intervalo fixo.
A maior parte do trabalho de um auditor realizada em amostras, a partir de uma
populao mais ampla. Use o comando Amostra para criar uma amostra de unidade
monetria (MUS) a partir de um campo de valor de estoque, onde:
Um item aleatoriamente escolhido a partir de cada intervalo de $30.000 reais e
Cada item maior que $25.000 selecionado e
O registro inteiro includo no arquivo denominado Inventory_mus
Captulo 4
Comandos
Sample (Amostra)
287
Na lista suspensa Amostra em, selecione o campo Valor (VALUE).

Marque o boto de seleo Intervalo fixo
Na caixa de texto Intervalo, digite 30000.
Na caixa de texto Incio, digite 234.
Na caixa de texto Limite, digite 25000.
Na caixa de texto Para, digite Inventory_mus.
Voc pode testar os registros amostrados por obsolescncia de estoque, comparaes do
valor de mercado com custo, preciso das extenses e qualquer outro teste relativo a
uma conta de estoque.
O arquivo Inventory_mus aparece com os resultados.
288

Sample (Amostra)
Manual de Referncia
Use a barra de rolagem para visualizar o arquivo inteiro. Como caracterstico de uma
amostragem MUS, foram selecionados valores monetrios maiores. O registro do
comando mostra uma informao resumida dos resultados.
O tamanho da amostra 24, com zero itens de camada superior. Tambm so exibidos
o total da populao a partir da qual foi criada a amostra, incluindo uma quebra desse
valor entre a camada superior e os demais valores, bem como o ponto inicial de seleo
para a amostra de intervalo fixo.
Exemplo 2
Use o comando Amostra para criar uma amostra aleatria de registros, a fim de determinar a concordncia com um conjunto de procedimentos de aprovao de transaes
de vendas. No teste de concordncia, o valor monetrio dos itens testados nem sempre
relevante; logo, a amostragem por unidade monetria no usada.
Selecione Registro como Tipo de amostra e Aleatrio como Parmetro de amostra. Para
gerar 26 itens distintos para teste, especifique 26 como tamanho de amostra.
Especifique 234 como origem aleatria. O ACL ir listar automaticamente o tamanho da
populao, neste caso, 152. Especifique que o registro inteiro deve ser copiado para o
arquivo de amostra, Ar_sample.
O arquivo Ar_sample reflete as alteraes.
Captulo 4
Comandos
Sample (Amostra)
289
Use a barra de rolagem para visualizar o arquivo inteiro. O Log de comando mostra uma
informao resumida dos resultados da amostragem.
O tamanho da amostra 26, com zero itens de camada superior. Tambm so exibidos
o total da populao a partir da qual foi criada a amostra, incluindo o valor inicial para
a amostra aleatria de registros.
O ACL exibe o tamanho da amostra com o nmero dos itens de camada superior, bem
como o total da populao de onde foi extrada a amostra, inclusive o valor inicial da
amostra aleatria de registros.
Depois de verificar sua amostra, voc pode utilizar o comando Avaliar para avaliar os
dados. Para obter mais informaes, consulte Evaluate (Avaliar) na pgina 176.

SAMPLE RECORD
SAMPLE <ON> nome-do-campo-numrico
<SUBSAMPLE>
<CUTOFF limite-da-camada-superior>
<NOREPLACEMENT>
Voc pode incluir as seguintes opes sintaxe:

INTERVAL = valor-do-intervalo FIXED = valor-inicial
INTERVAL = valor-do-intervalo RANDOM = origem-aleatria
RANDOM = origem-aleatria POPULATION = tamanho-da-populao
{NUMBER|SIZE} = tamanho-da-amostra
{<FIELDS> extrair-campos|RECORD}
<ORDER>
<TO criar-nome-de-arquivo|PRINT>
<HEADER cabealho>
<FOOTER rodap>
290

Save (Salvar)
Manual de Referncia
Save (Salvar)
Use o comando Salvar para armazenar definies de campo do arquivo de entrada atual
em um arquivo de rea de trabalho.
Este comando utilizado somente nas reas de trabalho e apenas no modo de comando.
Para obter mais informaes, consulte Emitir comandos na pgina 267 do
De forma muito semelhante definio de um arquivo de entrada, uma rea de trabalho
um arquivo que armazena definies de campo. Contudo, ela no est associada a um
arquivo de entrada especfico. As reas de trabalho so mais freqentemente usadas
para armazenar campos calculados para serem usados em mais de um arquivo de
entrada. Por exemplo, voc pode aplicar um conjunto de campos calculados para uma
anlise de arquivos de contas a receber, referentes a diferentes perodos e localizaes.
Se a rea de trabalho especificada j existir em seu documento atual, o ACL ir
perguntar se deseja substitu-la.
Para usar o comando Salvar, importante entender como as reas de trabalho operam.
Para obter mais informaes sobre as reas de trabalhos e como cri-las atravs da
janela Viso geral, consulte reas de trabalho na pgina 355 do Guia do Usurio do
ACL para Windows.
Parmetros
O comando Save (Salvar) tem o seguinte parmetro: Workspace (rea de trabalho).
Workspace (rea de trabalho)

Indica que voc deseja salvar em um arquivo de rea de trabalho.

SAVE WORKSPACE nome-da-rea-de-trabalho
campos-da-rea-de-trabalho
Exemplo
Para salvar os campos calculados GRMargin e PercMarg em uma rea de trabalho
denominada Inventory_margin, que calcula a margem unitria e o percentual da
margem unitria para itens de estoque, use o comando Save (Salvar), conforme descrito
a seguir.
Voc pode ento aplicar esses campos calculados a arquivos de estoque de diferentes
perodos ou divises. Todo campo referenciado pelos campos calculados na rea de
Captulo 4
Comandos
Search (Pesquisar)
291
trabalho deve ter nome idntico em todos os arquivos aos quais a rea de trabalho
aplicada.
Digite SAVE WORKSPACE INVENTORY_MARGIN GRMARG PERCMARG na caixa de
texto do Log de comando.
A rea de trabalho est agora pronta para ser ativada, emitindo-se o comando Activate
(Ativar). Consulte Activate (Ativar) na pgina 120 para obter mais detalhes.
Search (Pesquisar)
Use o comando Pesquisar para localizar:
Um nmero de registro especificado
O primeiro registro de um arquivo que atende a uma condio especificada
O primeiro registro em um arquivo indexado que atende ou excede um valor de

chave especificado, onde esse valor uma cadeia ou expresso de caracteres que
pode conter referncias a campos ou variveis.
Uma vez encontrado o registro, voc pode escolher entre realizar clculos com base nele
ou comparar seu contedo ao de um outro registro.
Nota: Se voc estiver usando um arquivo indexado com o comando Pesquisar, dever
saber se o ndice condicional ou no. Um ndice condicional exclui determinados registros
da exibio resultante e dos comandos emitidos quando est em vigor.
Consulte Index (ndice) na pgina 211 para obter mais detalhes.
Consulte tambm Find (Localizar) na pgina 195, Locate (Buscar) na pgina 230 e
Seek (Encontrar) na pgina 297.
Parmetros
O comando Search (Pesquisar) tem os seguintes parmetros: Buscar expresso, Expr,
Localizar literal, Localizar registro, Localizar se.
Expr
Permite que voc informe um nmero de registro ou expresso. Para inserir uma
expresso, digite-a diretamente na caixa de texto ou selecione [Expr] para exibir o
Construtor de expresses, a fim de ajud-lo a criar uma expresso. Consulte
Construtor de expresses na pgina 275 do Guia do Usurio do ACL para Windows
para obter mais detalhes.
292

Search (Pesquisar)
Manual de Referncia
Find Literal (Localizar literal)

Permite que voc localize o primeiro registro no arquivo de entrada indexado que tenha
um valor de chave de ndice igual a ou maior que o valor especificado. Se o valor de
chave especificado for encontrado, a exibio ser posicionada naquele registro. Do
contrrio, ser exibida a mensagem Nenhum ndice corresponde chave e o arquivo
ser posicionado no primeiro registro que tenha um valor de chave maior que o valor
especificado.
Para especificar uma cadeia de caracteres a ser encontrada, digite-a na caixa de texto. A
cadeia de caracteres no pode ser iniciada por espaos em branco e no pode estar entre
aspas. Pode ser menor que a chave de ndice, sendo que, quando isso acontece, o
comando Pesquisar compara o valor da chave de ndice somente at o tamanho da chave
de pesquisa especificada e posiciona o arquivo no primeiro registro que atende a
comparao.
Pr-requisito
O arquivo de entrada deve ser indexado com base em, no mnimo, um campo-chave
tipo caractere em ordem crescente. Outros campos-chave podem no ser de caractere
ou estar em ordem decrescente, mas sero excludos da lista. Por exemplo, se os
campos-chave indexados forem ProdCls (campo de caractere) crescente, Loc (campo
de caractere) crescente e QtyOH (campo numrico) decrescente, voc s poder
pesquisar com base em ProdCls e Loc, embora todas as listagens do arquivo estejam
tambm ordenadas em seqncia decrescente de quantidade (QtyOH).
Locate If (Localizar se)

Permite que voc encontre o primeiro registro no arquivo de entrada que atenda
condies especificadas. Esta opo processa o arquivo seqencialmente, at que o
primeiro registro que atenda condio seja encontrado, ou at que o final do arquivo
seja atingido.
A pesquisa seqencial, iniciando no primeiro registro e no se baseia em nenhum
campo-chave predefinido. A velocidade de processamento proporcional ao tamanho
do arquivo e localizao do registro em seu interior.
Para especificar uma condio, digite-a diretamente na caixa de texto ou clique em
[Expr] para exibir o construtor de expresses que ir ajud-lo a criar uma expresso.
Consulte Construtor de expresses na pgina 275 do Guia do Usurio do
Locate Record (Localizar registro)

Permite que voc encontre um nmero de registro especfico no arquivo. Se voc
selecionar esta opo, informe o nmero do registro na caixa de texto.
Captulo 4
Comandos
Search (Pesquisar)
293
Seek Expression (Buscar expresso)

Esta opo opera da mesma forma que a opo Localizar literal, exceto pelo fato de que
o ACL pressupe que o valor especificado a ser localizado uma expresso de caractere,
em vez de uma cadeia de caractere literal.
Por exemplo, suponha que voc queira localizar o primeiro registro que tenha um valor
de chave igual ao contedo da varivel X (que tem um sobrenome mantido de um
processamento anterior, como SMITH). Basta digitar a letra X na caixa de texto e o
arquivo ser posicionado no primeiro registro com um valor de chave SMITH ou no
prximo valor mais alto, conforme apropriado.
Se voc quiser localizar uma cadeia de caracteres simples, coloque-a entre aspas. Os
espaos em branco podem ser fornecidos aps a abertura das aspas.
Pr-requisito: Consulte o pr-requisito de Localizar literal, apresentado anteriormente.
Caixa de dilogo Pesquisar

Clique em
(Pesquisar) ou em Analisar na barra de menus e selecione Pesquisar para
exibir a caixa de dilogo Pesquisar.
Exemplo 1
Para localizar o registro de nmero 478 em um arquivo de contas a receber, use
Pesquisar com a opo Localizar registro.
294

Search (Pesquisar)
Manual de Referncia
O Log de comando indica que o registro 478 foi localizado e o arquivo est posicionado
naquele registro em sua exibio. Voc pode realizar anlises ou clculos posteriores,
com base em cada registro.
Exemplo 2
Para verificar um arquivo de cadastro de clientes em busca de um registro onde o nome
do cliente Syscom Gas, use a opo Localizar se do comando Pesquisar. Quando
houver mais de uma ocorrncia de Syscom Gas no arquivo, o ACL posicionar o arquivo
na primeira ocorrncia.
Captulo 4
Comandos
Search (Pesquisar)
295
A janela Log de comando indica que condio foi atendida pelo registro 47 e o ACL
posiciona o arquivo naquele registro, em sua exibio.
Exemplo 3
Para visualizar uma lista de clientes com base em Nova York (abrevia-se NY) use a
opo Localizar literal do comando Pesquisar. Certifique-se de que o arquivo est
indexado no campo que representa o local de residncia.
No caso das empresas atuantes em vrios estados, cidades ou pases que tm leis e
normas distintas (por exemplo, para os impostos sobre vendas) til acessar uma lista
de clientes agrupados por local de residncia.
296

Search (Pesquisar)
Manual de Referncia
O ACL posiciona o arquivo no primeiro registro para o qual encontra correspondente

para a cadeia literal NY. Como o arquivo est indexado, todos os clientes residentes em
NY so listados consecutivamente.
Para obter os mesmos resultados, voc tambm poderia:
Selecionar Buscar expresso, na caixa de dilogo Pesquisar e digitar NY na caixa

de texto.
Selecionar Localizar Se na caixa de dilogo Pesquisar e digitar STATE="NY" na
caixa de texto.

Para Localizar registro e Localizar se, consulte Locate (Buscar) na pgina 230.
Para obter informaes sobre Localizar literal, consulte Find (Localizar) na
pgina 195.
Para obter informaes sobre Buscar expresso, consulte Seek (Encontrar) na
pgina 297.
Captulo 4
Comandos
Seek (Encontrar)
297
Seek (Encontrar)
Use o comando Encontrar para mover-se diretamente para o primeiro registro em um
arquivo indexado, contendo uma determinada chave de pesquisa de caractere.
ACL para Windows.
O comando Encontrar permite que voc localize o primeiro registro no arquivo de
entrada indexado que possui um valor de chave de ndice igual ou maior que o valor de
uma determinada expresso de caractere. Se o valor de chave especificado for encontrado, a exibio ser posicionada naquele registro. Do contrrio, ser exibida a
mensagem Nenhum ndice corresponde chave e o arquivo ser posicionado no
primeiro registro que tenha um valor de chave maior que o valor especificado.
Aps o registro ser encontrado, voc pode querer exibi-lo ou realizar clculos com base
em seu contedo. Opcionalmente, voc pode comparar o contedo de um registro com
o de outro, ou com o de uma varivel.
Uma expresso de caractere pode incluir referncias a campos ou variveis, ou pode ser
uma cadeia literal. Para usar o comando Encontrar para localizar uma cadeia de caracteres, essa cadeia deve vir entre aspas.
Ao procurar valores que sejam iniciados por espaos em branco, voc deve usar o
comando Encontrar ou a opo Buscar expresso, do comando Pesquisar. Tambm
possvel usar os parmetros Prximo e Enquanto, com Encontrar.
Nota: A funcionalidade do comando Encontrar idntica da opo Buscar expresso,
do comando Pesquisar. O comando Pesquisar acessvel atravs da caixa de dilogo
Pesquisar sendo, conseqentemente, mais prtico de usar. Use Pesquisar em vez de
Encontrar sempre que possvel. Para obter mais informaes, consulte Search (Pesquisar)
na pgina 291.
Pr-requisitos
necessrio que o arquivo de entrada seja indexado por um campo de caractere em
ordem crescente.
298

Sequence (Seqncia)
Manual de Referncia

SEEK expresso-de-caractere
expresso-de-caractere Indica o valor da chave de ndice (entre aspas, caso se
trate de uma cadeia de caracteres simples) ou o nome de um campo ou varivel que

contenha um valor de caractere.
Sequence (Seqncia)
Use o comando Seqncia para determinar se os campos-chave do arquivo atual esto
em ordem seqencial ou para detectar e relatar falhas, duplicidades ou falta de nmeros
na seqncia.
Voc pode acessar Duplicidades e Falhas como comandos separados do menu Analisar,
ou pode marcar as caixas de seleo nas caixas de dilogo Seqncia, Falhas ou Duplicidades.
O comando Seqncia geralmente usado para procurar documentos duplicados ou
ausentes, tais como nmeros de fatura ou de cheque. Seqncia tambm freqentemente usado para determinar se um arquivo foi ordenado apropriadamente.
Seqncia sempre verifica os campos-chave designados, a fim de determinar se esto
em ordem seqencial, e relata os resultados. Voc pode especificar se a seqncia deve
ou no ser testada em ordem crescente ou decrescente. Os erros de seqncia so
relatados somente at um limite de erros especificado.
Os testes de falhas e os testes de duplicidades so includos no comando Seqncia
porque, para que esses testes sejam realizados com preciso, os dados precisam estar
ordenados apropriadamente. Para isso, voc pode marcar a caixa de seleo
Pr-ordenar ou usar o comando Ordenar ou ndice. O comando Seqncia sempre testa
os erros de ordenao de dados.
Nota: H comandos separados para Falhas e Duplicidades mas eles so sinnimos para
Seqncia e suas sintaxes de comando so idnticas. A palavra-chave Presort
(Pr-ordenar) est disponvel para Falhas e Duplicidades, mas no para Seqncia.
preferncia Execuo automtica de comandos, consulte Opes de comando na
Captulo 4
Comandos
Sequence (Seqncia)
299
Parmetros
Alm dos parmetros descritos a seguir, o comando Sequence (Seqncia) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), Ascending
(Crescente), Break (Quebra), Descending (Decrescente), File (Arquivo), File Type
(Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximos), Print (Imprimir),
Screen (Tela), Suppress (Suprimir outros), While (Enquanto). Para obter uma descrio
desses parmetros, consulte Captulo 3: Parmetros de comandos comuns.
Indica que voc deseja testar a existncia de duplicidades (ou um nmero maior de
repeties) nos registros do campo-chave. Consulte tambm Duplicates (Duplicidades) na pgina 174.
Error Limit (Limite de erro)

Especifica o nmero mximo de erros de seqncia de dados a serem relatados. Se o
comando Seqncia for executado em um Grupo, o ACL concluir a execuo do
comando para evitar interferncia no processamento do Grupo, mas nenhum outro
erro da seqncia de dados ser relatado. Limite de erro no afeta a informao de
Falhas ou Duplicidades.
Padro: 10. O padro pode ser alterado atravs da preferncia Opes de comando.
Consulte Opes de comando na pgina 319 do Guia do Usurio do
Gaps (Falhas)
Indica que voc deseja testar a existncia de falhas na seqncia do campo-chave. Falhas
no funciona se mais de um campo-chave for especificado. Consulte tambm Gaps
(Falhas) na pgina 197.
List Fields (Listar campos)

Permite que voc especifique uma lista de campos ou expresses que deseja incluir na
sada para um teste de duplicidades. Selecione os campos na caixa de listagem ou clique
em [Listar campos] para abrir a caixa de dilogo Campos selecionados.
Os campos so relatados em formato de colunas, sendo os itens duplicados exibidos em
linhas agrupadas. Uma linha em branco separa cada conjunto de duplicidades. Os
valores do campo-chave duplicado so relatados na primeira coluna, seguidos dos
campos especificados.
Esta opo s est disponvel nos testes de Duplicidades se Falhas no estiver selecionado.
300

Sequence (Seqncia)
Manual de Referncia
List Gap Ranges (Listar intervalos de falha)

Especifica que a lista de sada do teste de falhas deve relatar intervalos de falha, em vez
de listar cada item ausente. So listados valores do campo-chave em ambas as extremidades da falha.
List Missing Items (Listar itens ausentes)

Especifica que a lista de sada do teste de falhas deve listar cada item ausente. Se o
tamanho da falha for menor ou igual ao limite de itens (veja a seguir), cada chave
ausente ser listada. Se a falha for maior, sero listadas somente a primeira e a ltima
chave ausentes.
Por exemplo, voc pode ter um arquivo de fatura para diversas filiais, cada uma com sua
prpria seqncia de numerao. Quando voc atinge o ltimo nmero referente a uma
filial e inicia o primeiro nmero da filial seguinte, um intervalo ausente ser quase
sempre relatado.
Maximum Missing Items (Mximo de itens ausentes)

Especifica o nmero mximo de itens ausentes a ser relatado em uma determinada
falha, para o teste de Listar itens ausentes. Se o limite for excedido, os itens ausentes
sero relatados como um intervalo, como em Listar intervalos de falha.
O limite Mximo de itens ausentes no restringe o nmero total de itens ausentes
relatados, apenas o nmero relatado em uma falha especfica. Padro: 5 itens.
Sequence On (Seqncia em)

Especifica os campos ou expresses do arquivo de entrada nos quais voc deseja
verificar a ordem seqencial apropriada, duplicidades ou falhas. Selecione os campos na
caixa de listagem ou clique em [Seqncia em] para exibir a caixa de dilogo Campos
selecionados.
Caixa de dilogo Seqncia

Clique em
(Seqncia) ou em Analisar, na barra de menus e selecione Seqncia
para exibir a caixa de dilogo Seqncia.
Captulo 4
Comandos
Sequence (Seqncia)
301
Exemplo 1
Para verificar a existncia de duplicidades, falhas e erros de seqncia em um campo de
nmero de fatura contido em um arquivo de transaes de vendas, use Seqncia. Um
nmero de fatura registrado duas vezes ou omitido inteiramente pode indicar
problemas nos controles de um sistema de contabilidade. Falhas no controle resultam
em perda de receita.
Selecione o campo de nmero da fatura a partir da caixa de listagem [Seqncia em] e,
em seguida, selecione Duplicidades, Falhas e Listar intervalos de falha.
O ACL exibe o resultado no Log do comando. O resultado final do comando aparece
como segue. No h erros de seqncia de dados indicando que o arquivo de vendas foi
ordenado de maneira apropriada, com base no nmero da fatura. O nmero total de
falhas ou duplicidades 22.
302

Sequence (Seqncia)
Manual de Referncia
Exemplo 2
O mesmo exemplo executado utilizando a opo Listar itens ausentes e um limite de
itens de 6.
O ACL exibe o resultado no Log do comando. O resultado final do comando fornece

informaes adicionais. Observe que fornecido um intervalo, em vez de uma lista
detalhada, para os itens ausentes de 12878 a 12888. O intervalo fornecido porque o
nmero de itens ausentes excede o mximo de itens ausentes especificado.
Captulo 4
Comandos
Set (Definir)
303
Observe tambm que o primeiro exemplo relatou 22 erros, enquanto o segundo relatou
39. O motivo disso que as faturas 13030 e 13031 esto ambas ausentes. Isso contou
como um intervalo no primeiro exemplo, mas como dois itens no segundo. Consulte
Duplicates (Duplicidades) na pgina 174 e Gaps (Falhas) na pgina 197 para obter
outros exemplos.

SEQUENCE <ON> campo-chave <D>
<UNFORMATTED>
<HEADER cabealho>
<FOOTER rodap>
<DUPLICATES> <OTHER lista-de-campos>
<PRESORT>
<GAPS|MISSINGn>
<ERRORLIMIT=n>
<APPEND>
<OPEN>
Nota: No possvel usar a palavra-chave PRESORT (pr-ordenar) em um grupo de

comandos que esteja sendo executado no modo batch.
Set (Definir)
Utilize o comando Definir para alterar as preferncias do usurio no ACL. Este
comando permite personalizar o ambiente do ACL para atender suas necessidades.
304

Set (Definir)
Manual de Referncia
Algumas preferncias tm equivalentes na interface grfica ao usurio do ACL. Essas

preferncias podem ser definidas por meio da caixa de dilogo Editar preferncias do
ACL ou no modo de comando.
Algumas preferncias no tm equivalentes na interface grfica com o usurio do ACL.
Essas preferncias podem ser definidas somente no modo do comando.
Equivalentes de preferncias
Voc pode acessar as opes do comando Set (Definir) utilizando a caixa de dilogo
Editar preferncias do ACL. A tabela a seguir relaciona a opo Set do modo do
comando com a sua preferncia equivalente. Essas preferncias esto descritas em
Preferncias do ACL na pgina 309 do Guia do Usurio do ACL para Windows.
Opo de definio no modo de comandos Preferncia ACL equivalente
SET BEEP 0-255
Opes de interface
SET CENTURY 0-99
Opes de data
SET CLEAN ON|OFF
Opes de exibio
SET DATE 1|2|'cadeia'
Opes de data
SET DESIGNATION
Opes de exibio
SET EXACT ON|OFF
Opes do arquivo de entrada
SET FORMAT ON|OFF
SET MARGIN {LEFT| RIGHT|TOP|

BOTTOM} <TO> n
Opes de impresso
SET MONTHS <TO>

"jan;fev;mar;abr;mai;jun;
jul;ago;set;out;nov;dez"
Opes de data
SET ORDER <TO> 'cadeia'
SET OVERFLOW ON|OFF
Opes numricas
SET PERIODS <TO> "perodo1;

perodo2..."
Opes de data
SET READAHEAD <TO>

tamanho-do-buffer
SET SAFETY ON|OFF
Opes de interface
SET TEST ON|OFF
Opes de comando
SET VERIFY ON|OFF|BLANK
Opes numricas
Captulo 4
Comandos
Set (Definir)
305
Opo de definio no modo de comandos Preferncia ACL equivalente

SET WIDTH <TO> n
Opes numricas
Sem equivalentes de preferncias

As opes do comando Set (Definir) no tm equivalentes na caixa de dilogo Editar
preferncias do ACL e podem ser definidas somente no modo do comando. Geralmente, essas opes so utilizadas em batches.
Set Echo (Definir eco)

Ativa ou desativa o Log de comandos e resultados no Log de comando. Esta opo pode
ser usada para ocultar senhas ou eliminar detalhes de comando desnecessrios do Log
de comando. O comando Password (Senha) o mtodo mais indicado para ocultar
senhas. Padro: ON (ativado).
Nota: A opo Eco no substitui as medidas de segurana de dados apropriadas.
Quando voc usa o comando Set Echo com a opo None, nenhuma sada destinada ao
Log de comando registrada. Isso inclui os comandos interativos emitidos no ACL e
todos os batches executados.
Essa opo pode ser til na execuo de um teste longo ou na repetio de um comando
como Do (Executar) e Do While (Executar Enquanto). Talvez voc no deseje registrar
todas as sadas de testes e comandos que gerem um grande nmero de resultados no Log
de comando.
O prprio comando Set Echo registrado no Log de comando, para indicar que
algumas sadas aps esse comando no sero registradas.
Nota: Com a desativao do Log de comandos, alguns ou todos os comandos e resultados
no sero exibidos no Log de comando. Esses comandos e resultados no estaro disponveis para futuras anlises. Por isso, lembre-se de reativar o Log de comando. O melhor
mtodo consiste em inserir, ao mesmo tempo, os comandos Set Echo None e Set Echo On.
Em seguida, entre essas duas linhas, digite os comandos que voc no deseja registrar.
306

Set (Definir)
Manual de Referncia

SET ECHO {ON|NONE}
Exemplo
Para desativar o Log de comandos, ao repetir 100 vezes uma seqncia de comando:
COUNTER = 0
SET ECHO NONE
DO REPEAT_BATCH WHILE COUNTER < 100
SET ECHO ON
Set Filter (Definir filtro)

Limita os registros a serem examinados em um arquivo. Isso elimina a necessidade de
incluir um teste If (Se) em cada comando subseqente.
Todos os comandos aps Set Filter aplicam-se somente aos registros filtrados at que
voc emita um outro comando Set Filter ou Open (Abrir), ou desative o filtro.
SET FILTER <TO> teste
Exemplo
SET FILTER Amount > 1000
TOTAL Amount
STATISTICS Amount
COUNT IF Dept = "13"
equivale a:
TOTAL Amount IF Amount > 1000
STATISTICS Amount IF Amount > 1000
COUNT IF Amount>1000 and Dept="13"
As contagens de registros que atendem ao filtro e os testes If (Se) de qualquer comando

so relatados separadamente. No exemplo de Count (Contar) descrito anteriormente, o
resultado poderia ser:
90 de 500 corresponderam ao filtro: Amount > 1000
4 de 90 atenderam ao teste: Dept = "13"
Set History (Definir histrico)

Define o nmero mximo de entradas do histrico de um arquivo. Isso til se voc
quer manter mais ou menos entradas de Histrico do arquivo que o padro. Consulte
File history (Histrico do arquivo) na pgina 194 para obter mais detalhes. O padro
20.
Captulo 4
Comandos
Set (Definir)
307

SET HISTORY <TO> 0-100
Set Index (Definir ndice)

Abre um arquivo de ndice para o arquivo de entrada atual.
Nota: Uma maneira mais rpida de abrir um arquivo de ndice consiste em usar a Viso
geral, conforme descrito em Janela Viso geral na pgina 29 do Guia do Usurio do
ACL para Windows.
Padro: No definido.
Exemplo
Para abrir o ndice TEST:
SET INDEX TO TEST
Set Learn (Definir Learn)

Abre um arquivo de batch. Todas as entradas subseqentes (comandos, etc.) so registradas no batch at que Set Learn seja desativado.
O comando Set Learn equivale a selecionar o menu Ferramentas e escolher Ativar
gravador de batch. Consulte Criar batches na pgina 334 do Guia do Usurio do
ACL para Windows para obter mais detalhes. Padro: Desativado.
Exemplo
Para ativar o modo de gravao de batch e salvar os comandos no arquivo Ar_test:
SET LEARN TO AR_TEST
Set Loop (Definir Loop)

Quando voc usa o comando Loop, h uma possibilidade de que possa, acidentalmente,
entrar em um loop infinito. Set Loop evita isso, interrompendo o processamento depois
que o nmero de comandos especificado foi executado para qualquer registro. A
definio do mximo em zero desativa o teste de loop. O intervalo de 0-32767. Padro:
10000.
308

Set (Definir)
Manual de Referncia
Exemplo
Para abortar o processamento, caso mais que 20 comandos sejam executados para
qualquer registro:
SET LOOP TO 20
Set Log (Definir Log)

Altera o arquivo de Log do Projeto ACL para um outro arquivo de log. O Log padro
tem o mesmo nome do documento com a extenso .log. Voc pode especificar outro
arquivo de Log e o ACL registrar todas as atividades no novo arquivo de log. O ACL
insere uma linha no arquivo de Log para registrar o fato de que voc est mudando para
um arquivo de Log alternativo.
Isso til quando voc executa um batch ou comandos que gerem um grande volume de
dados de sada no Log de comando. Voc pode comutar para outro arquivo de Log, para
armazenar o Log durante o batch e, em seguida, retornar ao arquivo de Log original.
SET LOG <TO> {nome-do-arquivo-de-log|OFF}
Exemplo 1
Para comutar usando o Newlog.log como o arquivo de Log de comando:
SET LOG TO NEWLOG
Exemplo 2
Para retornar, usando o arquivo de Log de comando original:
SET LOG OFF
Set Password (Definir senha)

Define a senha para acessar arquivos protegidos por senha.
Nota: Antes de usar esse comando, consulte Password (Senha) na pgina 243 para
conhecer o mtodo indicado para a utilizao de senhas em batches. Voc deve garantir que
existam outras medidas de segurana para proteo das senhas.
Para impedir que a senha seja registrada no Log de comando, digite esse comando entre
os comandos Set Echo None e Set Echo On.
A senha permanece registrada no prprio arquivo de batch.
SET PASSWORD n <TO> <senha>
n deve ser um valor de 1 a 5.
Captulo 4
Comandos
Size (Tamanho)
309
senha pode ser qualquer expresso de caractere vlida.
Exemplo
Para definir a senha 1 como secreta:
SET PASSWORD 1 TO "secreta"
Size (Tamanho)
Use o comando Tamanho para determinar os tamanhos de amostra apropriados para
amostras de registro e por unidade monetria (MUS).
Nota: A teoria de amostragem estatstica complexa. Se voc no estiver familiarizado
com os julgamentos crticos necessrios durante a realizao de uma amostragem
estatstica, recomendamos que consulte um especialista em estatstica antes de usar os
comandos Tamanho, Amostra e Avaliar do ACL.
O comando Tamanho informa:
O tamanho de amostra necessrio.

O intervalo, com base no tamanho fornecido da populao (se for usada uma
amostra de intervalo).
A quantidade mxima de erros prevista para uma amostra.
O nmero de erros permitido para amostras de registro: se o nmero real de erros

for menor ou igual ao valor da amostra, os resultados so vlidos.
O mximo de contaminao tolervel para unidade monetria (MUS): uma vez que
os valores em dlares podem estar apenas parcialmente errados, o percentual de
erro para um determinado item chamado de contaminao. Por exemplo, um item
de $100 totalmente errado tem uma contaminao de 100%, enquanto um item de
$100 que deveria, na verdade, ter um valor de $93, tem 7% de contaminao. O
percentual mximo de erros tolerados a soma de todas as contaminaes por erros
individuais. Se essa soma for menor que o valor relatado no comando, os resultados
so vlidos.
O comando Tamanho cria automaticamente as variveis SAMPSIZE e SAMPINT que
contm, respectivamente, o tamanho e o intervalo da amostra resultantes. Use essas
variveis para criar batches que fornecem, automaticamente, parmetros para um
comando Amostra subseqente.
Quando forem encontrados erros e contaminaes, use o comando Avaliar para determinar seu impacto.
310

Size (Tamanho)
Manual de Referncia
Tamanhos da Amostra
O comando Tamanho gera os tamanhos de amostra por atributo. Ele no se destina a
gerar tamanho da amostra para amostragem por estimativa ou varivel.
O comando Tamanho produz tamanhos de atributo da amostra vlidos estatisticamente
para a maioria das anlises, exceto se:
Voc estiver fazendo amostragem de populaes muito pequenas.

Sua empresa tem especialistas internos em amostragem. Eles conseguem definir
tamanhos de amostra adequados s necessidades da empresa.
Sua empresa foi obrigada a utilizar outra ferramenta ou metodologia de
amostragem.
O ACL gera tamanhos de amostra utilizando a distribuio de Poisson, em vez da distribuio binomial. A vantagem da distribuio de Poisson que:
No exige que voc conhea o tamanho da populao antes de gerar um

tamanho de amostra.
Simplifica o clculo necessrio para produzir tamanhos de amostra e avaliar os
erros de amostra detectados.
A distribuio de Poisson muito utilizada para calcular os tamanhos da amostra.

mais fcil trabalhar com ela do que com a distribuio binomial e as tabelas de distribuio de Poisson esto disponveis quando for necessrio verificar os clculos.
Para as amostras do registro, a distribuio de Poisson gera o mesmo tamanho de
amostra, independentemente do tamanho da populao. Nos tamanhos de populao
mais caractersticos (mil registros ou mais), as duas distribuies geram tamanhos de
amostras quase idnticos. Para as populaes com menos de mil registros, os tamanhos
de amostra determinados com a distribuio de Poisson tendem a ser um pouco
maiores e, por isso, mais conservadores que os tamanhos determinados com a distribuio binomial. Isso porque a distribuio binomial ajusta o tamanho da amostra para
baixo, para populaes pequenas, mas a distribuio de Poisson no. Com populaes
muito pequenas, o tamanho da amostra fixo gerado pela distribuio de Poisson pode
realmente exceder o tamanho da populao.
Ao utilizar o comando Tamanho para amostragem de registro de populaes pequenas,
saiba que o tamanho da amostra pode ser maior do que voc precisa. Isso no representa um obstculo para a anlise, j que uma prtica comum testar com mais rigor as
populaes pequenas.
Para obter tamanhos da amostra do registro que no sejam significativamente diferentes
daqueles obtidas utilizando a distribuio binomial, no utilize o comando Tamanho
quando o tamanho da amostra gerado for maior que 10% da populao.
Captulo 4
Comandos
Size (Tamanho)
311
Parmetros
Alm dos parmetros descritos a seguir, o comando Size (Tamanho) tem os seguintes
parmetros: File (Arquivo), File Type (Tipo de arquivo), Footer (Rodap), Header
(Cabealho), Local (Local), Name (Nome), Screen (Tela). Para obter a descrio desses
parmetros, consulte Captulo 3: Parmetros de comandos comuns.
Monetary Unit Sample Size (Tamanho da amostra de unidade monetria)

Confiabilidade
Especifique a confiabilidade que voc gostaria que a amostra gerasse. Por exemplo, a
digitao de 95 na caixa de texto indica 95% de confiabilidade na amostra. Ou seja, a
probabilidade da concluso ser incorreta de uma em 20.
Total de erros previsto
Especifique o valor total em unidades monetrias referente aos erros esperados na
populao. Isto aumenta o tamanho da amostra por levar em conta os erros previstos.
Materialidade
Especifique o montante em dinheiro considerado relevante. Esse o montante mximo
que voc pretende aceitar na populao sem deteco.
Monetrio
Indica que ser extrada uma amostra por unidade monetria (MUS). A probabilidade
de um item ser selecionado proporcional ao seu tamanho.
Use amostragem de intervalo fixo, se voc pretende usar posteriormente o comando
Avaliar, a fim de avaliar algum erro.
Populao
Especifique o valor absoluto do campo que est servindo de amostra.
Record Sample Size (Tamanho da amostra do registro)

Confiabilidade
Especifique a confiabilidade que voc gostaria que a amostra gerasse. Por exemplo, a
digitao de 95 na caixa de texto indica 95% de confiabilidade na amostra. Ou seja, a
probabilidade da concluso ser incorreta de uma em 20.
Taxa de erros esperada
Especifique o percentual referente taxa de erros prevista na populao. Este o
montante mximo que voc pretende aceitar na populao sem deteco.
312

Size (Tamanho)
Manual de Referncia
Populao
Especifique a contagem de registros.
Registro
Indica que a amostra uma amostra por registro sem tendncia. A probabilidade de um
item ser selecionado no est relacionada a seu tamanho. Todos os registros tm iguais
probabilidades de seleo.
Limite de erro superior
Especifique a taxa de erros que voc deseja provar que no excedida na populao.
Caixa de dilogo Tamanho

A aparncia da caixa de dilogo Tamanho varia de acordo com a opo de amostragem
selecionada.
Opo monetrio
Clique em
(Tamanho) ou selecione a Amostragem na barra de menus, para exibir a
caixa de dilogo Tamanho. Como padro, o ACL exibe a opo Monetrio e seus
parmetros correspondentes.
Clique em [Calcular] para exibir os resultados calculados aps digitar os valores dos
parmetros Tamanho. O tamanho da amostra, o intervalo e e a porcentagem mxima de
erros tolerados so exibidos na rea Resultados da caixa de dilogo.
Captulo 4
Comandos
Size (Tamanho)
313
Opo registro
Clique em
(Tamanho) ou selecione Amostragem, na barra de menus, para exibir a
caixa de dilogo Tamanho. Como padro, o ACL exibe a opo Monetrio e seus
parmetros correspondentes. Selecione Registro para exibir a opo de amostra de
registros.
Clique em [Calcular] para exibir os resultados calculados aps digitar os valores dos
parmetros Tamanho. O tamanho da amostra, o intervalo e o nmero tolervel de erros
so exibidos na rea Resultados, da caixa de dilogo.
Exemplo 1
Para determinar o tamanho da amostra necessrio para obter 95% de confiabilidade de
que o total de erros, em uma populao de 40.000, no exceda 5% (2.000 erros), pressupondo-se que no haja erros na populao:
314

Size (Tamanho)
Manual de Referncia
necessrio criar uma amostra de 60 itens. Como o nmero de erros permitidos zero,
se for encontrado algum erro, voc no poder formular a sua hiptese com 95% de
confiabilidade. Se voc optar por criar a amostra acima usando um mtodo de seleo
de intervalo, um intervalo de 666,66 ser apropriado.
Exemplo 2
Para determinar o tamanho da amostra necessrio para ter 95% de confiabilidade de
que o total de erros em uma populao de 40.000 no excede 5% (2.000 erros), pressupondo-se que haja 2% de erros na populao (800 erros):
necessrio criar uma amostra de 184 itens. Como h quatro erros permitidos, desde
que haja quatro erros ou menos em uma amostra, sua hiptese ser comprovada com
Captulo 4
Comandos
Size (Tamanho)
315
95% de confiabilidade. Se voc optar por criar a amostra anterior usando um mtodo de
seleo de intervalo, um intervalo de 217,39 ser apropriado.
Nota: O tamanho da amostra neste exemplo significativamente maior que no Exemplo
1. Isto permite a ocorrncia dos erros que voc esperava detectar.
Exemplo 3
Para determinar o tamanho da amostra necessrio para que voc tenha 90% de confiabilidade de que o total de erros em uma populao de $60 milhes no exceda $1
milho, pressupondo-se que no haja erros na populao:
necessrio criar uma amostra de 138 itens. Como no h erros tolerados, se algum
erro for encontrado, sua hiptese no ser comprovada com 90% de confiana. Se voc
optar por criar a amostra acima usando um mtodo de seleo de intervalo, um
intervalo de $432.900,43 ser apropriado.
Exemplo 4
Para determinar o tamanho de amostra necessrio para que voc tenha 90% de confiabilidade de que o total de erros em uma populao de $60 milhes no exceda $1
milho, pressupondo-se que haja $50.000 de erros na populao:
316

Size (Tamanho)
Manual de Referncia
necessrio criar uma amostra de 150 itens. Como h $50.000 em erros previstos, um
certo valor de erros na amostra resultante tolerado. Desde que o total de contaminao
no exceda 12,54%, sua hiptese ser comprovada com 90% de confiana. Se voc optar
por criar a amostra acima usando um mtodo de seleo de intervalo, um intervalo de
$398.701,29 ser apropriado.
As seguintes possveis contaminaes e sua avaliao se referem ao Exemplo 4:
Um item de $950 registrado como um item de $1.000 implica em 5% de contaminao (50/1.000), sendo, portanto, aceitvel.
Dado o erro acima e um outro, onde um item de $15.000 foi registrado como
$14.000 (6,66% de contaminao; 1.000/15.000), os resultados ainda so
aceitveis porque o total de contaminaes de somente 11,66%.
Dados os dois erros acima e um outro onde um item de $100 foi registrado como
$98 (2% de contaminao), a amostra pode ser insuficiente para provar sua
hiptese, j que o total de contaminao de 13,66% (maior que 12,54%). Use o
comando Avaliar para confirmar o efeito dos erros.
Dado um nico erro na populao onde foi registrado um item de $100 por $80
(20% de contaminao), a amostra provavelmente insuficiente para provar sua
hiptese. Como o erro foi encontrado em um item, voc pode pressupor com
segurana que a amostra insuficiente.
Nota: Sempre que houver erros em sua amostra, voc pode usar o comando Avaliar para
determinar o impacto dos erros sobre seus resultados. Voc tambm pode usar o comando
Avaliar para determinar se uma determinada amostra monetria apropriada.
Captulo 4
Comandos
Sort (Ordenar)
317

SIZE MONETARY
POPULATION tamanho-da-populao
CONFIDENCE nvel-de-confiabilidade
MATERIALITY nvel-de-materialidade
<ERROR quantidade-de-erros-prevista>
<TO nome-do-arquivo-de-texto>
SIZE {RECORD|ATTRIBUTE}
POPULATION tamanho-da-populao
CONFIDENCE nvel-de-confiabilidade
PRECISION nvel-de-preciso
<ERROR taxa-de-erros-prevista>
<TO nome-do-arquivo-de-texto>
Sort (Ordenar)
Use o comando Ordenar para ordenar o arquivo de entrada atual em uma seqncia
crescente ou decrescente, com base em campos-chave especificados. O comando
Ordenar cria um novo arquivo que foi fisicamente reorganizado.
O comando Ordenar funciona com arquivos de dados com registro de tamanho fixo e
varivel.
Ordenao versus Indexao

O comando ndice uma alternativa para Ordenar. A ordenao mais lenta e requer
mais espao de disco que a indexao. Contudo, processar um arquivo ordenado
muito mais rpido que processar um indexado. A tabela a seguir compara as vantagens
e desvantagens dos comandos Ordenar e ndice.
Ordenao
Indexao
Velocidade de execuo
Mais lenta
Mais rpida
Tamanho de arquivo resultante
Maior
Menor
Espao em disco necessrio
Mais
Menos
Processamento subseqente de um
arquivo inteiro
Muito mais rpido
Muito mais lento
Processamento subseqente procurando

por alguns registros
Muito mais lento
Muito mais rpido
318

Sort (Ordenar)
Manual de Referncia
Para usar o comando Relacionamentos de dados e as opes Localizar literal e Buscar

expresso, na caixa de dilogo Pesquisar, voc precisa usar um arquivo que tenha sido
indexado, ao invs de ordenado.
O comando Ordenar ordena o arquivo de entrada em ordem crescente, de acordo com
os campos-chave que voc especificar, a menos que especifique ordem descendente. As
especificaes de ordenao crescente e decrescente de caracteres so especficas
somente para um campo em particular e podem ser misturadas em um comando
Ordenar (por exemplo, nmeros de conta em ordem crescente, montantes de transao
em ordem decrescente).
Se voc optar por ordenar mais de um campo-chave, precisar selecionar os
campos-chave na seqncia em que deseja orden-los (por exemplo, informe primeiro
o campo-chave primrio, em seguida o secundrio, e assim por diante). O comando
Ordenar ordena qualquer nmero de campos-chave, contanto que o comprimento
combinado dos campos-chave no exceda 255 caracteres.
Qualquer tipo de campo, incluindo campos calculados e as expresses especficas, pode
ser usado para ordenao e os vrios tipos de campo podem ser misturados livremente.
Os campos lgicos so ordenados colocando-se os valores falsos antes dos verdadeiros
e os campos numricos ou expresses so colocados em seqncia a partir do valor de
campo mais negativo para o mais positivo.
Nota: Ao processar arquivos do servidor que contenham arquivos selecionados, a sada
tipo registro ser sada de todos os campos, se voc especificar a opo ou a palavra-chave
local.
A incluso dos parmetros opcionais Se, Enquanto, Primeiros e Prximo faz com que
um subconjunto do arquivo de entrada atual seja ordenado no arquivo de sada.
Os registros ordenados de mesmo valor de chave mantm a mesma posio relativa, no
arquivo de sada. Por exemplo, numa ordenao crescente, os registros da empresa ABC
mantm sua ordem original, relacionados uns com os outros, mas so movidos como
um grupo acima dos registros da empresa BCD.
Nota: Se voc estiver conectado a um servidor OS/390, o ACL envia a mensagem de erro
Verificar %s para Mensagens do Programa de Ordenao do Sistema no Log de
comando, quando uma ordenao do sistema no servidor no for bem-sucedida. importante informar o contedo dessa mensagem equipe de suporte tcnico. Se no conseguir
resolver o problema, entre em contato com o Suporte Tcnico do ACL.
Captulo 4
Comandos
Sort (Ordenar)
319
Requisitos de espao em disco

A Ordenao requer um espao livre em disco de pelo menos 2,5 vezes o tamanho do
arquivo a ser ordenado.
Classificao versus Ordenao e Sumarizao

Como o comando Classificar no exige um arquivo ordenado, sempre que possvel use
Classificar em vez de Ordenar e depois Sumarizar, para preparar relatrios sumarizados. A odenao de um arquivo consome uma quantidade significativa de memria e
dever ser evitada se outros comandos do ACL puderem ser igualmente eficientes.
Parmetros
Alm dos parmetros descritos a seguir, o comando Sort (Ordenar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), Ascending
(Crescente), Descending (Descendente), First (Primeiros), If (Se), Local (Local), Next
(Prximo), To (Para), Use Output File (Usar arquivo de sada), While (Enquanto). Para
obter uma descrio desses parmetros, consulte Captulo 3: Parmetros de comandos
comuns.
Sort On (Ordenar em)

Especifica quais campos-chave do arquivo de entrada ou expresso devem ser utilizados
para a ordenao. Selecione os campos da lista de exibio ou clique em [Ordenar em]
para exibir a caixa de dilogo Campos selecionados, na qual voc pode escolher a ordem
crescente ou decrescente. Para obter mais informaes, consulte Caixas de dilogo
selecionar/editar na pgina 40 do Guia do Usurio do ACL para Windows.
Caixa de dilogo Ordenar

Clique em
(Ordenar) ou selecione Dados da barra de menus e escolha Ordenar para
exibir a caixa de dilogo Ordenar.
320

Sort (Ordenar)
Manual de Referncia
Exemplo
Neste exemplo voc ordena um arquivo de estoque por um campo-chave. Voc comea
com um arquivo de estoque no ordenado.
Para criar um arquivo de estoque denominado Sort_product_class, ordenado em

seqncia crescente (padro) por classe de produto (a segunda coluna na exibio):
1. Selecione Dados na barra de menus e escolha Ordenar para exibir a caixa de dilogo
Ordenar.
2. Selecione ProdCls na exibio da lista Ordenar em.
Captulo 4
Comandos
Sort (Ordenar)
321
A seqncia padro de ordenao crescente, mas se voc quiser alter-la pode

selecionar o campo a partir da caixa de dilogo Campos selecionados. Para fazer
isso:
Clique em [Ordenar em] para exibir a caixa de dilogo Campos selecionados.

Quando voc move o campo que deseja ordenar da exibio da lista Campos
disponveis para a caixa de listagem Campos selecionados, um indicador triangular aparece no nome do campo.
Clique no indicador para alterar a seqncia de ordenao.
Selecione o campo denominado ProdCls na lista, altere a seqncia de
ordenao se necessrio e clique em [OK] para voltar caixa de dilogo Ordenar.
A coluna aparece esquerda da exibio da lista Ordenar em, mostrando em
que seqncia os campos foram selecionados para ordenao.
3. Digite Sort_product_class na caixa de texto Para e, em seguida, clique em [OK] para

executar o comando e exibir os resultados. A exibio mostra o campo da classe do
produto ordenado em seqncia crescente.
322

Statistics (Estatsticas)
Manual de Referncia

SORT ON campo-chave <D>... TO nome-do-arquivo-a-ser-criado
<APPEND>
<OPEN>
Use o comando Estatsticas para calcular estatsticas descritivas com base em campos
numricos do arquivo de entrada atual.
O comando Estatsticas freqentemente usado para oferecer uma viso geral de um
arquivo de entrada, antes do processamento detalhado. Ele pode rapidamente destacar
anomalias no arquivo de entrada, as quais podem ento estabelecer uma direo para a
sua abordagem ou anlise subseqente.
Estatsticas fornece as seguintes informaes para os campos numricos:
Contagens de registro, totais de campo e valores mdios de campos para

registros positivos (dbitos), nulos, negativos (crditos), e para todos os
registros no arquivo
Valor absoluto
Intervalo (diferena entre os valores mnimo e mximo)
Desvio padro dos campos
Valores dos campos mais altos
Valores dos campos mais baixos
Alm de exibir as informaes estatsticas mencionadas anteriormente, o ACL

armazena diversos valores em variveis especiais. Consulte Variveis criadas por
comandos na pgina 345 do Guia do Usurio do ACL para Windows para obter
detalhes.
Parmetros
Alm dos parmetros descritos a seguir, o comando Statistics (Estatsticas) contm os
seguintes parmetros: All (Tudo), File (Arquivo), File Type (Tipo de arquivo), First
(Primeiros), Footer (Rodap), Graph (Grfico), Header (Cabealho), If (Se), Local
(Local), Name (Nome), Next (Prximo), Print (Imprimir), Screen (Tela), While
Captulo 4
Comandos
323
(Enquanto). Para obter uma descrio desses parmetros, consulte Captulo 3:

Number of High/Low (Nmero demaiores/menores)

Especifica o nmero de valores mais altos e mais baixos a serem reportados. Padro: 5.
Standard Deviation (Desvio padro)

Ative essa opo para calcular o desvio padro dos campos especificados, alm das
outras estatsticas.
Statistics On (Estatsticas em)

Especifica os campos ou expresses para os quais sero fornecidas estatsticas. Selecione
os campos na caixa de listagem ou clique em [Estatstica em] para abrir a caixa de
dilogo Campos selecionados. Para obter mais informaes, consulte Caixas de
Caixa de dilogo Estatsticas

Clique em
(Estatsticas) ou em Analisar, na barra de menus e selecione Estatsticas
para exibir a caixa de dilogo Estatsticas.
Exemplo
Este exemplo mostra como obter estatsticas de vrios campos, utilizando [Se] para
especificar uma condio e exibir as variveis criadas automaticamente pelo comando.
324

Manual de Referncia
O comando Estatsticas permite criar uma viso geral do estoque no Local 3, um dos
diversos locais de estoque da empresa. Os auditores podem querer estatsticas da
quantidade disponvel, do valor de estoque e do valor de mercado, antes de realizarem
uma contagem fsica no local. A gerncia pode querer pesquisar a existncia de itens
incomuns, tais como quantidades disponveis negativas, que possam indicar um
problema no controle do sistema.
Selecione os campos referentes quantidade disponvel, valor de estoque e valor de
mercado na lista de exibio. Na caixa de texto [Se] especifique que deseja estatsticas
somente para o Local 3.
O ACL exibe os resultados no Log do comando.
Captulo 4
Comandos
325
Os resultados do comando identificam vrias caractersticas importantes desses dados:
O total negativo no campo QtyOH (quantidade disponvel) pode indicar um

problema no sistema.
Os cinco itens com valor mais alto constituem uma proporo significativa do
valor total, devendo, portanto, ser verificados em uma contagem fsica.
Como previsto, o valor total do mercado excede o valor do estoque.
As variveis criadas pelo comando Estatsticas so freqentemente usadas para

controlar a execuo de batches. Para exibir uma lista das variveis, selecione Editar na
barra de menus e escolha Variveis.
Voc tambm pode usar o comando Display (Exibir) no modo de comandos, para
exibir as variveis criadas por esse comando. Para fazer isso, digite DISPLAY
VARIABLES na caixa de texto do Log de comando. O ACL exibe o resultado no Log de
comando.
326

Stratify (Estratificar)
Manual de Referncia
Para obter mais detalhes, consulte Variveis na pgina 343 do Guia do Usurio do
ACL para Windows.

STATISTICS <lista-de-campos-numricos|ALL>
<STD> <NUMBERn>
<TO nome-do-arquivo|PRINT>
<IF teste> <WHILE teste><FIRST|NEXT intervalo>
<ANEXO>
Use o comando Estratificar para contar o nmero de registros que recaem sobre intervalos especificados (camadas) de valores de expresses ou campos numricos, bem
como para acumular um ou mais campos para cada camada. A contagem dos registros
de cada camada relacionada na coluna COUNT, no Log do comando.
O comando Estratificar trabalha com arquivos no ordenados e particularmente til
para uma rpida varredura e sumarizao. Estratificar permite que voc conte o nmero
de registros que recaem sobre determinado nmero de intervalos uniformes, fornecendo totais por camada para os campos numricos selecionados. Alternativamente,
voc pode especificar os pontos de incio dos intervalos, utilizando a opo Livre para
criar intervalos personalizados de qualquer tamanho.
Este comando pode ser de execuo automtica. Para obter mais informaes, consulte
Execuo automtica de comandos na pgina 319 do Guia do Usurio do
ACL para Windows.
Captulo 4
Comandos
327
Parmetros
Alm dos parmetros descritos a seguir, o comando Stratify (Estratificar) tem os
Next (Prximo), Print (Imprimir), Screen (Tela), Suppress (Suprimir outros), Use
Output File (Usar arquivo de sada), While (Enquanto). Para obter a descrio desses
parmetros, consulte Captulo 3: Parmetros de comandos comuns.

Especifica as expresses ou campos numricos para os quais o ACL fornece totais por
camada. Selecione os campos na caixa de listagem ou clique em [Acumular campos]
para abrir a caixa de dilogo Campos selecionados.
Exibir lista na pgina 42 do Guia do Usurio do ACL para Windows.
Free (Livre)
Permite que voc especifique o ponto inicial de cada intervalo e o ponto final do ltimo
intervalo. Digite esses valores na caixa de texto Livre, um por linha.
Intervals (Intervalos)
Especifica o nmero de intervalos uniformes produzidos pelo ACL ao longo do
intervalo (de Mnimo a Mximo). O padro 10, mas voc pode alter-lo na caixa de
dilogo Editar preferncias do ACL. Consulte Intervalos na pgina 321 do
Maximum (Mximo)
Especifica o valor mximo do ltimo intervalo de estratificao. Se voc emitiu o
comando Perfil ou Estatsticas anteriormente, o valor mais alto no campo aparecer por
padro. Se voc especificou intervalos livres, o valor mais alto especificado ser exibido
como padro.
Minimum (Mnimo)
Especifica o valor mnimo do primeiro intervalo de estratificao. Se voc emitiu o
comando Perfil ou Estatsticas anteriormente, o valor mais baixo no campo estratificado
aparecer como padro.
328

Manual de Referncia
Stratify On (Estratificar em)

Especifica a expresso ou campo numrico a ser estratificado. Selecione o campo na lista
suspensa ou clique em [Estratificar em] para abrir a caixa de dilogo Campos selecionados.
Caixa de dilogo Estratificar

Clique em
(Estratificar) ou em Analisar na barra de menus e selecione Estratificar
para exibir a Caixa de dilogo Estratificar.
Exemplo 1
Neste exemplo, voc ir produzir estratificaes de intervalos uniformes.
Uma anlise estratificada de um arquivo de contas a receber mostra se ele contm alguns
itens de valor maiores ou vrios menores. Essa informao pode ajudar o gerenciamento a desenvolver os procedimentos de cobrana apropriados.
Antes de utilizar Estratificar nesse tipo de arquivo, til primeiro usar dois comandos
do ACL:
1. Sumarizar. Um arquivo de contas a receber contm vrias transaes individuais,
mas voc quer os saldos das contas. Voc pode obter os saldos das contas dos clientes
utilizando o comando Sumarizar. Sumarize o arquivo pelo campo nmero do cliente
Captulo 4
Comandos
329
e acumule o campo valor da transao (amount). Utilize a opo Pr-ordenar com

o comando Sumarizar.
2. Estatsticas ou Perfil. Use um desses comandos para analisar o campo do valor da
transao, a fim de informar automaticamente ao ACL os valores mnimo e mximo
encontrados no campo valor (amount). Esta informao necessria para o
comando Estratificar.
3. Agora, estratifique o arquivo dos saldos pelo valor da transao e acumule o campo
valor da transao (amount). Aceite os padres para os valores de intervalo mnimo
e mximo (pressupondo-se que j tenha sido emitido anteriormente um comando
Perfil ou Estatsticas). Aceite 10 como o nmero de intervalos.
O ACL exibe o resultado no Log de comando. Embora 46,89% dos clientes tenham
dbitos de menos de 983,10 cada, esta camada representa 42,90% do total do saldo
de contas a receber.
330

Manual de Referncia
Exemplo 2
Neste exemplo, voc produz estratificaes de intervalo livre.
A estratificao do intervalo livre permite obter mais uma diviso da camada do
Exemplo 1, contendo 46,89% dos clientes.
Selecione [Livre] e, em seguida, especifique 0, 100, 250, 500 e 750 como seus pontos
iniciais de intervalo e 1000 como o ponto final.
Captulo 4
Comandos
331
O Log de comando mostra que a maioria dos saldos de 69,89 a 983,10 esto no intervalo
de 500 a 750.
Sada do comando
A sada no Log de comando tem colunas para os intervalo de camadas, o nmero dos
registros em cada intervalo e o percentual do total de registros que cada intervalo representa. Se um ou mais campos forem acumulados, sero exibidas colunas adicionais:
outra coluna percentual e os totais acumulados dos campos para cada intervalo.
Cada coluna percentual aponta para a coluna que ela representa. A coluna percentual
direita aponta para a coluna do campo acumulado mais prximo e mostra o percentual
do valor total representado por esse intervalo. Os percentuais no so fornecidos para
colunas de campos acumulados adicionais.
Voc pode enviar a sada do comando para um grfico. Clique na guia [Sada] e
selecione a opo Grfico, na caixa de dilogo ou clique duas vezes na sada do comando
ou na instruo <<<Dados do grfico>>> no Log de comando. Para obter mais
informaes, consulte Sada para grfico na pgina 263 do Guia do Usurio do
ACL para Windows.
Voc pode gravar a sada do comando em um arquivo. Clique na guia [Sada] e selecione
a opo Arquivo e, em seguida, selecione o Tipo de arquivo da lista suspensa.
332

Manual de Referncia

STRATIFY <ON> nome-do-arquivo-a-ser-criado <INTERVALS=n>
MAXIMUM=mx
MINIMUM=mn
STRATIFY <ON> nome-do-campo-numrico FREE
pontos-iniciais-do-intervalo...
MINIMUM=mn
<MAXIMUM=mx>
Voc pode acrescentar as seguintes opes a cada formato de sintaxe:

<SUPPRESS>
<ACCUMULATE lista-de-campos-numricos>
<HEADER cabealho>
<FOOTER rodap>
<KEY campo-de-quebra <+....>>
<APPEND>
<OPEN>
Use o comando Sumarizar para gerar totais de contagem de registros e de valor de
campos numricos, para cada valor distinto dos campos-chave de caractere em um
arquivo ordenado.
O comando Sumarizar permite que voc acumule totais de campos numricos para
cada valor distinto dos campos-chave tipo caractere. O nmero de registros pertencentes a cada valor distinto exibido em um campo gerado pelo ACL, denominado
COUNT. O nmero de valores de campos de caractere distintos que podem ser sumarizados quase ilimitado.
Devido ao fato de poder fornecer relatrios sobre um nmero ilimitado de valores
nicos de campos-chave tipo caractere, o comando Sumarizar mais eficiente para
arquivos com muitas entradas. O comando Sumarizar exige um arquivo ordenado pelos
campos-chave de caractere, por isso, voc deve antes ordenar o arquivo ou marcar a
caixa de seleo Pr-ordenar. No caso de arquivos no ordenados de tamanho pequeno
ou mdio, Classificar um comando eficiente para sumarizar os dados. Para obter mais
informaes, consulte Classify (Classificar) na pgina 136.
O comando Sumarizar permite que voc selecione Outros campos ..., campos de
caractere ou campos numricos a serem includos em sua sada. O primeiro dos
Outros valores de campo encontrado no arquivo de entrada ordenado pertencente a
um determinado grupo sumarizado gravado no arquivo resumido como sendo um
Captulo 4
Comandos
333
dos Outros valores de campo para aquele grupo. Voc pode desejar incluir um
Outro campo no arquivo sumarizado, se o valor desse campo for constante ao longo
de todo o grupo sumarizado. Por exemplo, se voc criou a sumarizao com base no
nmero do cliente (um campo de caractere), talvez queira especificar o nome do cliente
como sendo o Outro campo, j que o relacionamento entre o nmero do cliente e o
nome do cliente de um para um. Voc pode criar um novo arquivo de entrada com o
comando Sumarizar e usar o arquivo para posterior anlise e gerao de relatrios com
o ACL.
Nota: Voc pode utilizar o comando Sumarizar para remover registros duplicados de um
arquivo. Para fazer isso, especifique o campo de caractere a sumarizar, no acumule
nenhum campo, selecione Outros campos e, em seguida, selecione Adicionar Tudo e envie
a sada para um arquivo. O arquivo de sada conter somente registros nicos.
Pr-requisitos
Este comando requer que todos os arquivos sejam pr-ordenados com base nos
campos-chave tipo caractere, na seqncia de sumarizao pretendida. Se o arquivo no
estiver ordenado, voc pode orden-lo ou index-lo, ou marcar a caixa de seleo
Pr-ordenar.
Nota: Certifique-se de que a caixa de seleo Pr-ordenar esteja desativada ao utilizar um
arquivo de ndice.
Parmetros
Alm dos parmetros descritos a seguir, o comando Summarize (Sumarizar) tem os
seguintes parmetros: All (Tudo), Append (Anexar a um arquivo existente), File
(Grfico), Header (Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo),
Print (Imprimir), Screen (Tela), Use Output File (Usar arquivo de sada), While
(Enquanto). Para obter uma descrio desses parmetros, consulte Captulo 3:

Especifique as expresses ou campos numricos a serem totalizados pelo ACL para cada
valor distinto de um campo-chave tipo caractere. Selecione os campos na caixa de
listagem ou clique em [Acumular campos], para abrir a caixa de dilogo Campos selecionados.
334

Manual de Referncia
Other Fields (Outros campos)

Indica as expresses ou campos adicionais a serem includos nos registros sumarizados.
A sada do valor para o arquivo sumarizado selecionada a partir do primeiro registro
pertencente a cada grupo sumarizado encontrado no arquivo de entrada ordenado.
Selecione os campos na caixa de listagem ou clique em [Outros campos] para abrir a
Caixas de dilogo selecionar/editar na pgina 40 do Guia do Usurio do
ACL para Windows.
Os campos j selecionados nas caixas de lista Sumarizar em e Acumular campos no
precisam ser selecionados aqui novamente.
Summarize On (Sumarizar em)

Indica as expresses ou campos de caractere a serem sumarizados. Selecione os campos
na caixa de listagem ou clique em [Sumarizar em] para abrir a caixa de dilogo Campos
selecionados.
Caixa de dilogo Sumarizar

Clique em
(Sumarizar) ou selecione Dados da barra de menus e escolha Sumarizar
para exibir a caixa de dilogo Sumarizar.
Captulo 4
Comandos
335
Exemplo
Voc sumarizar sobre dois campos neste exemplo. Para sumarizar o estoque por local
e, em cada local, por classe de produto, use Sumarizar. Os Auditores podem fazer essa
sumarizao para direcionar seus procedimentos de teste, e a gerncia para melhor
controlar o estoque.
Na caixa de listagem [Sumarizar em], selecione primeiro o campo referente ao local,
depois o campo referente classe de produto. Acumule os campos quantidade disponvel, valor registrado e valor de mercado na caixa de listagem [Acumular campos]. Se o
arquivo de entrada no estiver ordenado, marque a caixa de seleo Pr-ordenar.
Clique na guia [Sada] e envie a sada para um arquivo denominado
Summarize_sort_location.
A exibio padro de Summarize_sort_location apresentada com base na entrada

anterior.
336

Tape (Fita)
Manual de Referncia

SUMMARIZE ON campos-chave ACCUMULATE campos-a-sumarizar
<OTHER outros-campos>
<TO nome-de-arquivo-a-ser-criado>
<PRESORT>
<APPEND>
<OPEN>
Nota: No possvel usar a palavra-chave PRESORT (pr-ordenar) em um grupo de

comandos que esteja sendo executado no modo batch.
Tape (Fita)
Utilize o comando Fita para buscar um arquivo especfico em uma fita, contendo dados
de um mainframe ou minicomputador. Voc tambm pode utilizar o comando para
rebobinar uma fita.
Este comando s pode ser executado no modo de comando.
Os arquivos em fita so organizados consecutivamente e cada arquivo separado por
um espao vazio conhecido como marcador de arquivo (file mark). Dois marcadores de
arquivo consecutivos indicam o final dos dados na fita.
Quando uma fita rebobinada, o ACL automaticamente posiciona a unidade no
primeiro arquivo da fita. Mas com o comando Fita voc pode ir para outro arquivo ou
voltar para trs rebobinando a fita. O modo como voc se move para outro arquivo
depende se a sua fita est com ou sem rtulo (label).
Captulo 4
Comandos
Tape (Fita)
337
Voc deve calcular o nmero de marcas de arquivo a saltar. A frmula a ser utilizada
varia, se a fita tiver ou no um rtulo.
A fita sem rtulo contm blocos seqenciais de dados.
Marcador de
arquivo
Dados 1
Bloco de
dados
Dados 2
Dados 3
Dados 4
Dados 5
A fita com rtulo contm um bloco adicional de dados, denominado rtulo, antes e
depois de cada bloco de dados.
Marcador Bloco de
de arquivo dados
Rtulo
Rtulos
Dados 1
Rtulo
Rtulo
Dados 2
Rtulo
Rtulo
Para mover-se a um arquivo diferente do primeiro na fita, com ou sem rtulo:
Calcule o nmero de marcadores de arquivo que voc quer saltar.
Utilize a quantidade calculada no comando Fita.
Parmetros
O comando Tape (Fita) tem o seguinte parmetro: Skip (Saltar).
Skip (Saltar)
Especifica que a fita avana/retrocede para um arquivo ou bloco de dados especfico.

TAPE <SKIP> n
n especifica quantos marcadores de arquivo saltar.
Exemplo 1: Fita sem rtulo

Para calcular n, o nmero de marcadores de arquivo a saltar, especifique n = (d1),
onde d o nmero de blocos de dados que voc deseja acessar. Para ir para o bloco de
dados 3, especifique n = (31) = 2.
TAPE SKIP 2
O ACL salta dois marcadores de arquivo, levando voc ao terceiro bloco de dados.
338

Top (Acima)
Manual de Referncia
Exemplo 2: Fita com rtulo

Para calcular o nmero de marcadores de arquivo a saltar, utilize a frmula 3(d1)+1,
onde d o nmero do bloco de dados que voc quer acessar. Para ir para Dados 2, na fita
com rtulo mencionada anteriormente, n = 3(21)+1 = 4:
TAPE SKIP 4
O ACL salta quatro marcadoress de arquivo, levando voc ao quinto bloco de dados,
Dados 2.
Exemplo 3: Rebobinar fita

Voc pode rebobinar a fita especificando um grande valor negativo. O sinal de
subtrao informa o ACL para mover a fita para trs. Se voc estiver trabalhando com
uma fita que contenha muitos arquivos, verifique se especificou um nmero suficiente
de marcadores de arquivo para se mover para o incio da fita. Especifique o seguinte:
TAPE SKIP -10
Top (Acima)
Use o comando Acima para mover-se para o primeiro registro do arquivo de entrada
atual.
ACL para Windows.
Este comando til aps um parmetro de escopo Next (Prximo) ou While
(Enquanto) ter posicionado o arquivo em um registro diferente, ou aps um registro
especfico ter sido localizado com o comando Search (Pesquisar).

TOP
Total
Captulo 4
Comandos
Verify (Verificar)
341
O ACL exibe o resultado no Log de comando. O valor de mercado (MKTVAL) maior

que o custo de estoque (VALUE); portanto, no h superavaliao aparente do custo do
estoque para a classe 8. Para realizar esta mesma anlise em um nvel mais detalhado,
voc pode alterar o teste, conforme apropriado.

TOTAL lista-de-campos-numricos
Verify ( Verificar)
Use o comando Verificar para verificar a existncia de erros de validade dos dados no
arquivo de entrada atual.
O comando Verificar , geralmente, um dos primeiros comandos usados quando se est
lidando com um novo arquivo de entrada. Verificar assegura que os dados de um
arquivo esto em conformidade com as definies de arquivo de entrada e relata
quaisquer erros encontrados.
O comando Verificar usa a descrio da definio de arquivo de entrada para verificar os
campos especificados, em busca de erros de validade de dados. Todos os campos
definidos so analisados para garantir que os dados estejam consistentes com o tipo de
340

Total
Manual de Referncia
Exemplo 1
Este exemplo totaliza um campo de valor, a fim de determinar o valor total de estoque
para reconciliao com registros de contabilidade. Selecione o campo Value (Valor)
registrado a partir da caixa de listagem Totalizar campos.
O ACL exibe o resultado no Log de comando.
Exemplo 2
Este exemplo totaliza os registros que atendem a uma condio especificada.
Para totalizar um campo de valor de mercado e um campo de valor de estoque para uma
determinada classe de produto, use Total. Em geral, uma classe de produto sofre uma
queda no valor de mercado devido a mudanas econmicas ou tecnolgicas. Para
assegurar-se de que o valor registrado sempre menor ou igual ao valor de mercado,
voc talvez queira comparar esses dois totais para uma classe de produto.
Selecione os campos referentes ao valor de mercado e ao valor de estoque a partir da
caixa de listagem. Na caixa de texto [Se], fornea uma expresso que limite sua anlise
classe de produto 8:
Captulo 4
Comandos
Verify (Verificar)
341
O ACL exibe o resultado no Log de comando. O valor de mercado (MKTVAL) maior

que o custo de estoque (VALUE); portanto, no h superavaliao aparente do custo do
estoque para a classe 8. Para realizar esta mesma anlise em um nvel mais detalhado,
voc pode alterar o teste, conforme apropriado.

TOTAL lista-de-campos-numricos
Verify ( Verificar)
Use o comando Verificar para verificar a existncia de erros de validade dos dados no
arquivo de entrada atual.
O comando Verificar , geralmente, um dos primeiros comandos usados quando se est
lidando com um novo arquivo de entrada. Verificar assegura que os dados de um
arquivo esto em conformidade com as definies de arquivo de entrada e relata
quaisquer erros encontrados.
O comando Verificar usa a descrio da definio de arquivo de entrada para verificar os
campos especificados, em busca de erros de validade de dados. Todos os campos
definidos so analisados para garantir que os dados estejam consistentes com o tipo de
342

Verify (Verificar)
Manual de Referncia
campo especificado. Por exemplo, Verificar confere se somente dados de caractere

constam dos campos de caractere e dados numricos dos campos numricos.
Os campos de caractere so verificados em busca de caracteres no imprimveis e os
campos numricos so verificados em busca de caracteres numricos imprprios. Por
exemplo, o comando Verificar comprova a existncia de mais de um sinal + ou -
esquerda, ou mais de uma vrgula decimal.
Voc pode optar entre fazer com que Verificar pare a execuo, sempre que encontre
dados invlidos ou continuar o processamento, substituindo os dados invlidos por
espaos em branco.
Para obter mais informaes, consulte Opes de exibio na pgina 317 do
Voc tambm pode fazer com que o ACL verifique todos os campos existentes, todas as
vezes em que usar um arquivo de entrada, ativando a opo Verificar dados. Para ativar
esta opo, selecione Editar na barra de menu e escolha Preferncias. Clique na guia
[Opes numricas] e ative a opo Verificar dados. A ativao dessa opo torna o ACL
um pouco mais lento, pois resulta na verificao inicial dos dados.
Nota: Para testar os dados vlidos em um campo calculado, use a funo VERIFY( ) e
depois tome a medida apropriada.
Consulte VERIFY( ) na pgina 87 para obter detalhes.
Parmetros
Alm dos parmetros descritos a seguir, o comando Verify (Verificar) tem os seguintes
parmetros: All (Tudo), Append (Anexar a um arquivo existente), File (Arquivo), File
Type (Tipo de arquivo), First (Primeiros), Footer (Rodap), Graph (Grfico), Header
(Cabealho), If (Se), Local (Local), Name (Nome), Next (Prximo), Print (Imprimir),
Screen (Tela), While (Enquanto). Para obter a descrio desses parmetros, consulte
Error Limit (Limite de erro)

Especifique o nmero de erros permitido antes do comando ser concludo.
Padro: 10. Para alterar a definio padro, selecione Editar na barra de menus e escolha
Preferncias. Clique na guia [Opes de Comando] e aumente ou diminua o nmero
contido na caixa de texto Limite de erro.
Captulo 4
Comandos
Verify (Verificar)
343
Verify Fields (Verificar campos)

Especifique as expresses ou campos do arquivo de entrada a serem verificados.
Selecione os campos na caixa de listagem ou clique em [Verificar campos] para exibir a
Embora voc possa verificar a validade desses campos, os campos calculados, juntamente com as expresses especficas e campos binrios so, por definio, sempre
vlidos.
Para obter mais informaes, consulte Caixas de dilogo selecionar/editar na
Caixa de dilogo Verificar

Clique em
(Verificar) ou em Analisar, na barra de menus e selecione Verificar para
exibir a caixa de dilogo Verificar.
Exemplo
Este exemplo verifica todos os campos de um arquivo.
Para verificar a validade dos dados, com referncia definio de arquivo de entrada,
use Verificar. Se voc no tiver certeza sobre a integridade dos dados, poder executar o
comando Verificar antes de processar, de forma detalhada, qualquer arquivo de entrada.
Selecione todos os campos da caixa de listagem e aceite o Limite de erro padro definido
em 10.
344

Verify (Verificar)
Manual de Referncia
O ACL exibe o resultado no Log de comando.
O ACL exibe a localizao dos dados invlidos e, em baixo, sua representao hexadecimal.
Voc pode usar o comando Descarregar para analisar o contedo de cada registro
invlido. Consulte Dump (Descarregar) na pgina 170 para obter mais detalhes.
Captulo 4
Comandos
Verify (Verificar)

VERIFY lista-de-campos
<ERRORLIMIT n>
<TO nome-de-arquivo-a-ser-criado|PRINT>
345
346

Verify (Verificar)
Manual de Referncia
Apndice A
C OMO USAR O UTILITRIO ACL
O ACL para Windows permite que voc utilize os arquivos de formato, batches e
relatrios do ACL for OS/390. Entretanto, preciso primeiro converter os arquivos em
uma das duas maneiras a seguir:
Use o utilitrio de converso do ACL para converter vrios arquivos ao mesmo

tempo
Use a opo Importar do ACL for OS/390 no ACL para Windows para converter e
importar somente os arquivos ACL for OS/390 desejados
Converter do OS/390 para Windows

Consulte tambm Janela Viso geral na pgina 29 do Guia do Usurio do
ACL para Windows para obter informaes sobre o uso do boto Importar do
ACL for OS/390.
A opo Converter do OS/390 do Utilitrio de Converso do ACL transforma todos os
formatos, batches, espao de trabalho e arquivos de relatrios do ACL for OS/390 em um
diretrio e os inclui em um nico Projeto do ACL para Windows. recomendvel
revisar os diretrios que contm seus arquivos do ACL for OS/390 antes de convert-los.
Voc pode querer reorganizar os arquivos para incluir somente aplicativos relacionados
no Projeto convertido.
O utilitrio s converte arquivos com extenses FMT, BAT, WSP e RPT. Se voc deseja
converter arquivos de formato, batch, rea de trabalho ou relatrio que tenham
extenses diferentes dessas, dever renome-los.
uma boa idia remover arquivos temporrios, de teste e redundantes que voc no
espera usar novamente. Isto ir resultar em um conjunto de arquivos convertidos limpo
e organizado.
Certifique-se de que h espao em disco livre suficiente para armazenar o novo
conjunto de arquivos que o utilitrio ir criar. Ser necessrio um espao em disco
aproximadamente igual ao total dos arquivos FMT, BAT, WSP e RPT que deseja
converter.
347
348

Manual de Referncia
Para converter arquivos do ACL for OS/390:

1. No grupo do programa do ACL, d um clique duplo no cone Utilitrio do ACL para
exibir a janela Utilitrio de converso do ACL para Windows Verso 7.
2. Clique em Converter na barra de menus e escolha OS/390 para Windows.
O ACL exibe uma mensagem informando que seus arquivos do ACL for OS/390 sero
convertidos e colocados em um Projeto do ACL para Windows. Clique em [OK].
3. Localize o diretrio que contm os arquivos que voc deseja converter. Crie o novo
Projeto no diretrio que contm os arquivos que voc est convertendo.
4. Na caixa de texto Nome do arquivo, digite um nome para o Projeto em que o ACL
incluir os arquivos convertidos e clique em [Salvar].
O ACL exibe a janela de converso e verifica o diretrio quanto a arquivos de
formato, relatrio e batch.
Quando a verificao estiver completa, o ACL exibe a caixa de dilogo Converter
com todos os itens pr-selecionados. Para aceitar todos os itens, clique em [OK].
Se deseja selecionar somente alguns dos itens exibidos na caixa de dilogo
Converter, utilize o boto Importar do OS/390 na janela Viso Geral.
Apndice A
Como usar o utilitrio ACL

349
Relatrios a serem convertidos em exibies
Batches a serem
convertidos
reas de trabalho a serem

convertidas
Arquivos de formato a serem convertidos em

definies de arquivo de entrada
5. Quando a converso estiver completa, revise a informao na janela Status da

converso. Procure mensagens de informao e erro, consultando a seo
Mensagens de converso abaixo, pois algumas mensagens podem requerer ao.
6. Quando terminar, selecione Converter na barra de menus e escolha Sair.
Mensagens de converso
A janela Status da converso pode exibir um dos seguintes tipos de mensagens durante
a converso:
As mensagens informativas indicam o status e a operao atual do utilitrio.

As mensagens de erro indicam problemas que o utilitrio encontrou, mas que
no so graves o bastante para evitar que continuem.
As mensagens de erro fatal indicam que a converso foi interrompida. Embora o
utilitrio salve o trabalho feito at aquele ponto, o trabalho pode no ser vlido.
Mensagens informativas
Processando batches
Indica que o utilitrio est processando atualmente todos os arquivos de batch (*.bat)
que encontra no diretrio selecionado.
350

Manual de Referncia
Processando formatos
Indica que o utilitrio est processando arquivos de formato (*.fmt). O utilitrio vincula
os arquivos que foram usados nos batches. Se um formato no foi usado em um batch,
o utilitrio considera um arquivo de dados do mesmo nome, mas com extenso FIL.
Processando arquivos de relatrio

Indica que o utilitrio est processando arquivos de relatrio (*.rpt). O utilitrio vincula
o relatrio definio de arquivo de entrada correta (formato).
Formato do relatrio
Relaciona os arquivos de relatrio e formatos utilizados.
Processando reas de trabalho

Indica que o utilitrio est processando arquivos de rea de trabalho (*.wsp).
Mensagens de erro
<nomedoarquivo> truncado em <n> caracteres
Indica que, ao processar arquivos de batch, um comando Open foi encontrado com um
nome de arquivo que excedia o comprimento mximo permitido de oito caracteres.
nome do formato <nomedoarquivo> truncado

Indica que, ao processar arquivos de formato, foi encontrado um nome de formato que
excedia o comprimento mximo permitido de oito caracteres.
O utilitrio trunca o nome de formato no comprimento mximo permitido e no inclui
uma extenso de arquivo.
Nome de formato muito longo

Indica que um arquivo de relatrio foi encontrado com um nome que excedia o comprimento mximo permitido de oito caracteres.
formato <nomedoarquivo> invlido,

Indica que, ao processar um arquivo de formato, uma linha RECORD_LENGTH no
foi encontrada.
Por no ser um formato vlido, ele no includo no Projeto criado.
Apndice A

Uso de arquivos do OS/390 convertidos
351
Campo de data formatado incorretamente

Indica que ao processar um arquivo de formato, um campo definido como tipo de
campo Data foi encontrado com um formato de data invlido.
O campo Data invlido no est includo no Projeto.
Mensagens de erro fatal

No h memria suficiente para processar comentrios
No h memria suficiente para processar batches
Indica que no h RAM suficiente para processar. Saia de quaisquer outros programas
que estejam abertos e tente executar a converso novamente.
Erro ao gravar projeto composto

Indica que o utilitrio no consegue gravar no Projeto que est criando. Isto s deve
acontecer se no houver espao em disco. Libere espao em disco e tente fazer a
converso novamente.

Todos os arquivos convertidos aparecem na janela Viso geral. Para exibir a janela Viso
geral, faa o seguinte:
1. Inicie o ACL para Windows e consulte o diretrio de trabalho para abrir o Projeto
com os arquivos convertidos.
2. Selecione Janela na barra de menus e escolha Abrir viso geral.
O ACL exibe a janela Viso geral, que mostra os Batches, Definies de arquivo de
entrada (formatos), Exibies (relatrios) e reas de trabalho includas em seu
Projeto.
352

Manual de Referncia
Para expandir a lista de batches, definies de arquivo de entrada, exibies e reas de

trabalho em seu Projeto, clique em ao lado do cone apropriado.
Para recolher a lista, clique em
. Os itens abertos atualmente so listados em negrito.
Para abrir Exibies, Definies de arquivo de entrada, rea de trabalho ou ndice,

simplesmente clique duas vezes em seu cone ou nome, ou arraste e solte na rea de
trabalho do aplicativo. Os batches podem ser executados ou editados da mesma
maneira.
Batches
Arquivos de batch convertidos aparecem na lista de batches da janela Viso geral.
Nota: necesssrio examinar e executar os batches antes de us-los para produo. Pode
no ser possvel executar os batches convertidos no ACL para Windows por diversos
motivos. Procure mensagens indicando comandos que no so permitidos.
Por exemplo, o comando Extrair no requer mais uma condio. Se tiver um batch que
inclua o comando Extrair, voc pode precisar edit-lo antes que seja executado.
Arquivos de formato
Arquivos de formato convertidos tornam-se definies de arquivo de entrada e so
armazenados como parte do Projeto. O ACL no armazena arquivos de dados como
parte do Projeto. Em vez disso, quando voc abre uma definio de arquivo de entrada,
o ACL automaticamente vincula-o ao arquivo de dados apropriado.
Apndice A

353
Para obter mais informaes sobre o relacionamento entre os arquivos de dados e as

definies de arquivo de entrada, consulte Arquivos de Projeto ACL na pgina 71 do
A maioria de suas definies de arquivo de entrada est vinculada ao arquivo de dados
como parte do processo de converso e importao. Algumas vezes, entretanto, o ACL
no consegue fazer o vnculo. Por exemplo, um arquivo de formato no referenciado em
um batch e nomeado de forma diferente do arquivo de dados no ser vinculado. O ACL
solicita que voc localize o arquivo de dados na primeira vez que selecionar o arquivo de
entrada para uso. Desse momento em diante, o vnculo automtico.
Relatrios
Os relatrios so baseados em exibies, por isso os relatrios convertidos aparecem no
novo Projeto como exibies.
O ACL exibe todos os relatrios convertidos (exibies) na janela Viso Geral sob
Exibies. Os relatrios citados em um batch possuem o nome do arquivo de entrada
correspondente exibido entre colchetes aps o nome do relatrio. Todos os outros
relatrios convertidos possuem a palavra desconhecido entre colchetes, porque o ACL
no pode vincul-los a um arquivo de dados especfico.
1. Para acessar os relatrios que possuem uma definio de arquivo de entrada desconhecida, faa o seguinte:
Na janela Viso Geral, clique duas vezes no nome da definio de arquivo de

entrada ao qual o relatrio se aplica, ou
Selecione Dados na barra de menus e escolha Selecionar. O ACL exibir a caixa
de dilogo Selecionar definio de arquivo de entrada. Selecione o arquivo de
entrada apropriado e clique em [OK].
2. Clique duas vezes no nome do relatrio que deseja vincular.

O ACL exibe o relatrio e automaticamente vincula-o definio de arquivo de
entrada aberta atualmente. O relatrio aparece na janela Viso geral, localizado sob
seu arquivo de entrada associado.
Exclua o relatrio antigo com o arquivo de entrada desconhecido.
354

Manual de Referncia
Apndice B
T RABALHAR COM FITA
A fita magntica uma forma importante de acessar e ler dados gerados em um

mainframe ou minicomputador.
possvel usar o ACL para acessar e ler dados de fitas em bobinas ou cartuchos. to
fcil quanto ler dados de uma unidade de disco, embora o hardware de unidade de fita
possa ser razoavelmente caro, dependendo das suas necessidades.
Tudo o que voc precisa para trabalhar com fitas de uma unidade de fita compatvel
com seu computador, um driver de dispositivo, uma placa controladora e um cabo de
conexo compatvel com o ACL. No necessrio um software de download separado
ou de grandes quantidades de espao em disco para armazenar os dados, j que estes
permanecem na fita.
possvel ler arquivos de dados armazenados em mais de uma bobina de fita ou
cartucho, ou mais de um arquivo do mesmo tipo armazenado em uma nica fita.
Esta seo inclui:
Uma viso geral dos componentes que formam um sistema de unidade de fita
Uma descrio da organizao dos dados na fita
Instrues passo-a- passo que voc pode seguir para ler os dados da fita
Dicas para solucionar problemas
Nota: Se voc usou o ACL for OS/390 para acessar dados em fita, talvez j esteja familiarizado com muitas das operaes descritas neste captulo.
Aquisio de um sistema de unidade de fita

Se for necessrio adquirir uma unidade de fita, um driver do dispositivo, uma placa
controladora ou um cabo, esta seo ajudar voc a determinar as melhores opes para
o seu ambiente de trabalho.
Se voc tem um departamento de sistemas de informaes, consulte esses profissionais
ao planejar e adquirir o sistema de unidade de fita. Isso garantir que os componentes
adquiridos sero compatveis com as fitas com as quais voc ir trabalhar.
Tambm possvel contatar o Suporte Tcnico da ACL para obter conselhos e sugestes
sobre a configurao de um sistema de unidade de fita.
355
356

Aquisio de um sistema de unidade de fita
Manual de Referncia
Componentes do sistema de unidade de fita

Os componentes de um sistema de unidade de fita so:
unidade de fita
driver de dispositivo
placa controladora
cabos de conexo
Juntos, os componentes permitem o acesso e a leitura de dados gerados em um

mainframe ou minicomputador e armazenados na fita magntica.
Unidade de fita
O ACL pode ler dados diretamente de quase todos os formatos de fita, inclusive:
fitas de 9 trilhas de polegada
cartuchos 3480 da IBM
fitas de 8 mm
fitas DAT de 4 mm
Se for necessrio ler dados de fitas de de polegada, entre em contato com o Suporte
Tcnico da ACL para obter assistncia.
O seu drive de fita deve trabalhar com SCSI (pronuncia-se scuzzy), um padro de
interface paralela, para ser compatvel com o ACL.
A velocidade de acesso aos dados de uma fita depende da velocidade da sua unidade de
fita.
Nota: possvel conectar mais de uma unidade de fita ao seu computador. Neste caso,
certifique-se de ligar apenas a unidade a partir da qual voc pretende ler os dados. Ao
conectar e executar vrias unidades de fita, o ACL acessa apenas a primeira unidade
designada na cadeia SCSI.
Driver do dispositivo
O driver de dispositivo funciona como um tradutor entre o ACL e a placa controladora.
A placa controladora no consegue compreender os comandos do ACL sem a interveno do driver de dispositivo. O ACL para Windows Verso 7 requer um driver
WINASPI.
Apndice B
Trabalhar com fita

Antes de iniciar
357
Placa controladora
A placa controladora do seu computador funciona como uma ligao entre o computador e a unidade de fita. A placa, junto com o driver de dispositivo, controla o fluxo de
dados da unidade de fita.
possvel utilizar qualquer placa SCSI que tenha drivers compatveis com ASPI.
Utilitrios de fita
As placas controladoras geralmente incluem utilitrios que ajudam a realizar funes de
fita padro, como:
Posicionamento da fita
Transferncia de dados em disco para uma fita e dados em fita para disco
Transferncia do contedo da fita (dumping) para a tela ou impressora
Se voc no possui um software utilitrio, contacte o fornecedor do seu hardware para

obter assistncia.
Cabo de conexo
O cabo conecta a unidade de fita ao computador. Para usar o ACL com uma fita, necessrio usar um cabo compatvel com SCSI.
Antes de iniciar
Antes de comear a ler os dados armazenados na fita, certifique-se de ter:
Uma cpia de trabalho do arquivo de dados da fita, no uma cpia de backup.

Solicite explicitamente um arquivo seqencial que no tenha sido convertido
para ASCII (a converso para ASCII muitas vezes feita automaticamente). O
ACL l dados no-convertidos de forma mais rpida e h menor chance de os
dados serem alterados.
Uma definio ou layout de arquivo.

Por exemplo, os tipos de campos em cada registro, seu comprimento, ordem
seqencial, etc.
Informaes sobre a organizao dos dados na fita.

Por exemplo, se a fita rotulada ou no-rotulada.
Quando tiver todas as informaes sobre a fita e o arquivo com o qual deseja trabalhar,
e a fita estiver na unidade, voc est pronto para comear.
358

Como os dados so organizados na fita
Manual de Referncia

Conhecer o layout fsico da fita com a qual est trabalhando ajuda voc a posicionar
corretamente a sua unidade nos dados que deseja acessar.
Data sets e marcas de arquivo

Os dados da fita so organizados em uma seqncia de arquivos consecutivos (denominados data sets) separados por marcas de arquivo.
As informaes de cada arquivo so divididas em blocos que a unidade de fita trata
como uma unidade. Um bloco pode conter um ou mais registros de dados. Entre cada
bloco da fita existe uma lacuna falha ou espao vazio. Aps o ltimo bloco de dados,
existem duas marcas de arquivo que indicam o fim dos dados gravados na fita.
As fitas podem ser no-rotuladas ou rotuladas.
Fita no-rotulada
Uma fita no-rotulada organizada em arquivos de dados consecutivos separados por
marcas de arquivo. Os retngulos escuros representam marcas de arquivo.
Marcador de
arquivo
Dados 1
Bloco de
dados
Dados 2
Dados 3
Dados 4
Dados 5
Para acessar um arquivo que no seja o primeiro, especifique o nmero do arquivo

menos um, j que o ACL automaticamente posiciona a unidade no incio do primeiro
arquivo.
Fita rotulada
Uma fita rotulada contm um bloco de dados extra (denominado rtulo) antes e
depois de cada arquivo. O rtulo fornece informaes sobre o arquivo de dados e como
o arquivo foi gravado.
Marcador Bloco de
de arquivo dados
Rtulo
Dados 1
Rtulos
Rtulo
Rtulo
Dados 2
Rtulo
Rtulo
Se quiser acessar um arquivo que no seja o primeiro em uma fita rotulada, use a
frmula 3(d-1)+1 para calcular o nmero de blocos de dados a serem saltados, onde n
o nmero do arquivo que voc deseja acessar. Por exemplo, se voc deseja acessar o
quinto arquivo em uma fita rotulada, digite TAPE SKIP 13 no Log de comando.
Apndice B
Trabalhar com fita

359
Posicionar a fita
Antes de acessar um arquivo na fita, preciso posicionar a fita no incio do arquivo.
Uma fita rebobinada j est corretamente posicionada para ler o primeiro arquivo, j
que o ACL acessa automaticamente o primeiro arquivo nas fitas rotuladas ou
no-rotuladas.
Se quiser acessar um arquivo que no seja o primeiro da fita, preciso saber se est
trabalhando com uma fita rotulada ou no-rotulada, e usar o comando tape do ACL
para posicionar a fita corretamente:
1. Na barra de comandos, selecione Janela e escolha Abrir Log de comando.
O ACL exibe o Log de comando.
2. Emita o comando Tape de uma das seguintes formas:
Para posicionar uma fita no-rotulada, especifique o nmero de arquivos a

serem ignorados at alcanar o arquivo que voc deseja acessar.
O ACL posiciona automaticamente a unidade no incio do primeiro arquivo na
fita. Subtraia o nmero deste arquivo do nmero do arquivo que voc deseja
acessar. Por exemplo, se voc quiser acessar o arquivo cinco em uma fita
no-rotulada, digite TAPE SKIP 4 na caixa de texto da janela Log de comando.
Para posicionar uma fita rotulada, especifique o nmero de marcas de arquivo

para ir at o arquivo que voc deseja acessar utilizando a frmula 3(d-1)+1.
Consulte Fita rotulada na pgina 358.
Rebobinar a fita
Se voc no tiver certeza de que a fita est posicionada no incio do arquivo que deseja
acessar, especifique um valor negativo como TAPE SKIP -10 na caixa de texto do Log
de comando.
Especificar um nmero negativo grande (tal como -10) faz com que o ACL rebobine
completamente a fita. O sinal de menos informa ao ACL para voltar a fita. Se voc estiver
trabalhando com uma fita que contm um nmero muito grande de arquivos, talvez seja
preciso rebobinar mais de 10 marcas de arquivo.

TAPE <SKIP> n
n igual ao nmero de marcas de arquivo a serem ignoradas. Digite n positivo para
avanar na fita ou n negativo para retornar.
360

Manual de Referncia
Acelerar o rebobinamento da fita

Se voc estiver trabalhando com um arquivo de dados muito grande, voc pode utilizar
o comando Set com a palavra-chave Accelerate para acelerar a velocidade de rebobinamento. preciso especificar o nmero de marcas de arquivo a serem puladas no incio
do arquivo.
Por exemplo, se o primeiro arquivo que voc deseja ler estiver em uma fita no-rotulada,
digite SET ACCELERATE 0 na caixa de texto do Log de comando. Se o primeiro
arquivo que voc quiser ler estiver em uma fita rotulada, ignore o rtulo da fita,
digitando SET ACCELERATE 1.

SET ACCELERATE n
n igual ao nmero de marcas de arquivo a serem puladas.
preciso cancelar o comando Set Accelerate para retornar velocidade de rebobinamento normal. Para cancelar Set Accelerate, digite:
SET ACCELERATE 100
Alternar entre a fita e o disco

Se voc quiser alternar um arquivo na fita para um arquivo no disco que possua a
mesma definio de arquivo de entrada, simplesmente selecione Dados na barra de
menus e escolha Selecionar. Clique em [Vincular arquivo de dados] para exibir a caixa
de dilogo Selecionar arquivo. Em seguida, selecione o arquivo que voc deseja utilizar
na caixa de dilogo Selecionar arquivo.
Para voltar para a fita mais tarde, voc pode escolher tanto Fita - Uma bobina quanto
Fita - Vrias bobinas, conforme apropriado, localizados na caixa suspensa Tipo de
mdia, na janela Definio de arquivo de entrada.
Se voc quiser usar um arquivo diferente na fita que possua a mesma definio de
arquivo de entrada, basta instalar outra fita.
Nota: Voc no pode utilizar
(Vincular a novo arquivo de dados) na janela Viso
geral ou o boto [Vincular arquivo de dados] na caixa de dilogo Selecionar definio de
arquivo de entrada, porque esta opo permite apenas o vnculo com arquivos em disco ou
em um servidor.
Apndice B
Trabalhar com fita

Trabalhar com arquivos de fita
361
Trabalhar com arquivos de fita

Para comear a trabalhar com arquivos de fita, preciso primeiro abrir uma definio
de arquivo de entrada j existente ou criar uma definio de arquivo de entrada. Siga as
instrues em Manteno das Definies dos arquivos de entrada na pgina 184 do
Guia do Usurio do ACL para Windows para abrir uma definio de arquivo de entrada
j existente a ser usada com arquivos de dados na fita.
Criar uma definio de arquivo de entrada

A criao de uma definio de arquivo de entrada para dados em fita similar criao
de uma definio de arquivo de entrada para dados de qualquer outra origem. A nica
diferena que voc seleciona a opo Fita na pgina Selecionar origem dos dados do
Assistente de definio de dados. Em seguida, voc pode continuar a definir o arquivo
de entrada da mesma maneira que faria para arquivos com base em disco. Consulte
Definir dados com o assistente na pgina 119 do Guia do Usurio do
ACL para Windows.
Nota: Se voc no tiver uma fita na unidade de fita ou se a fita no estiver conectada
adequadamente ao computador, o ACL exibir uma mensagem de erro lembrando-o de
verificar esses dois itens.
Processar arquivos da fita

Depois de definir um arquivo de fita, voc poder utilizar mais comandos e funes do
ACL para process-lo. Durante o processamento de arquivos de fita:
Voc no pode usar um arquivo na fita como um arquivo secundrio nos

comandos Associar ou Mesclar.
Voc no pode usar o comando ndice para indexar um arquivo na fita, j que a
fita no um dispositivo de acesso aleatrio.
Ao trabalhar com fitas de vrios carretis, voc pode processar todo o arquivo,
mas poder visualizar somente um carretel de cada vez.
Voc no pode enviar uma sada para a fita.
Feche o arquivo da fita antes de fechar o Projeto ou sair do ACL, porque no incio
da prxima sesso o ACL tentar acessar o ltimo arquivo de entrada em uso.
362

Resolver problemas de fita
Manual de Referncia
Resolver problemas de fita

Se voc estiver tendo problemas para fazer o ACL funcionar com a sua unidade de fita,
verifique o seguinte:
A chave de hardware do ACL est conectada porta paralela do seu computador?
A sua unidade de fita SCSI est corretamente terminada?

Usando SCSI, voc pode vincular at sete dispositivos. Se a sua unidade de fita
for o ltimo dispositivo na cadeia SCSI, ela dever ser terminada com um terminador SCSI.
Voc verificou a existncia de conflitos de hardware IRQ/DMA?

Seu computador possui um nmero limitado de canais IRQ e DMA para as
placas de expanso (tal como a sua placa de vdeo) instaladas nele.Verifique se a
placa SCSI instalada no est em conflito com nenhuma das outras placas de
expanso.
Se voc observou esses procedimentos de soluo de problemas, mas ainda est tendo
problemas para ler a fita com o ACL, entre em contato com o Suporte Tcnico da ACL.
Apndice C
G LOSSRIO
Esta seo contm uma lista em ordem alfabtica de termos do ACL e seus significados.
Mais informaes sobre cada termo, junto com exemplos prticos de seu uso no ACL,
esto includas nas sees apropriadas do Guia do Usurio.
Amostragem de unidade monetria
Abrevia-se como unidade monetria (MUS). Em amostragem, um mtodo de seleo
de registros em que a probabilidade de seleo proporcional ao valor de um campo;
quanto maior o valor do campo, maior a possibilidade de esse campo ser selecionado.
Amostragem por registro
Em amostragem, um mtodo de seleo de registros em que cada registro possui a
mesma chance de ser selecionado. A amostragem por registro tambm conhecida
como amostragem por atributo.
Anexar
Um processo de adicionar os registros de sada de um comando ao fim de um arquivo j
existente. Anexar pode ser usado em vez de mesclar em vrias situaes.
Consulte tambm Mesclar na pgina 372.
rea de trabalho
Um arquivo que armazena definies de campo que podem ser aplicadas a diversos
arquivos de dados. Geralmente, trata-se de campos calculados que se referem ao
ambiente atual, mas tambm podem ser descries e nomes de campo exclusivos. O uso
de um arquivo de rea de trabalho permite que voc estenda o seu arquivo de entrada
atual sem ter que definir campos extra.
rea de trabalho do aplicativo
O local em que voc executa o seu trabalho no ACL. a rea em que as janelas e as caixas
de dilogo do ACL so exibidas.
Argumento
Um valor de campo ou expresso de qualquer tipo, usado em um teste.
Aritmtica de ponto fixo
Um mtodo de processamento usado pelo ACL para todas as operaes numricas (em
oposio aritmtica de ponto flutuante). A aritmtica de ponto fixo aprimora a
velocidade de processamento e permite que o usurio tenha controle sobre nmeros
decimais e arredondamento.
363
364
Manual de Referncia
Arquivo CR
Um arquivo em que o fim de um registro indicado por um retorno de carro (CR). Esta
a forma padro de separar arquivos de linha em computadores compatveis com
Macintosh.
Arquivo CR/LF
Um arquivo de comprimento de registro varivel em que o fim de um registro indicado
por um caractere de retorno de carro (CR) e de alimentao de linha (LF).
Arquivo de dados
Um arquivo em que so armazenados dados existentes em um computador. Tambm
chamado de arquivo-fonte. Na verdade, esse arquivo no est armazenado como parte
de um Projeto ACL mas sim vinculado ao Projeto pela definio de arquivo de entrada.
O ACL no altera o arquivo de dados de forma alguma.
Arquivo de entrada
Um termo que se refere ao arquivo de dados juntamente com a definio de arquivo de
entrada.
Consulte tambm Arquivo de dados na pgina 364 e Definio de arquivo de
entrada na pgina 368.
Arquivo de log
Um registro cumulativo de todos os comandos emitidos do ACL, seguidos por seus
resultados, durante as sesses anteriores do ACL at o momento em que o Log foi limpo
pela ltima vez.
O ACL cria automaticamente um arquivo de log especfico para o Projeto criado, e grava
a data e a hora de cada comando.
Arquivo de relatrio
Um arquivo que geralmente uma duplicata exata de um relatrio impresso em formato
eletrnico. Algumas vezes tambm chamado de arquivo de spool de impresso.
Arquivo de vrias bobinas
Um arquivo de dados que se expande por mais de uma bobina ou cartucho de fita
magntica, ou que se expande por alguns data sets em uma bobina ou cartucho que
possua o mesmo formato de campo.
Arquivo de vrios tipos de registros
Um arquivo de dados que contm mais de um tipo de registro. Por exemplo, um arquivo
de relatrio que possui cabealho, registros de detalhe e de finalizao. O comprimento
do registro pode ser fixo ou varivel.
Apndice C
Glossrio
365
Arquivo delimitado
Arquivos em que cada campo em um registro separado dos outros por um caractere
separador de campo. Os campos no possuem uma posio fixa.
Existem duas convenes principais para arquivos delimitados: CSVs (Valores
separados por vrgula) e TSVs (Valores separados por tabulao). Em ambos os casos,
um retorno de carro (CR) e um avano de linha (LF) geralmente separam cada registro
no arquivo.
Arquivo legado
Arquivos de dados mais antigos gerados principalmente em computadores mainframe.
Estes tipos de arquivos no possuem definio de dados interna, sendo assim, preciso
criar uma definio de arquivo de entrada para eles.
Consulte tambm Definio de arquivo de entrada na pgina 368.
Arquivo primrio
O arquivo nico em que voc est trabalhando no momento. Voc s pode abrir um
arquivo primrio de cada vez. Um arquivo primrio e um secundrio so usados em
operaes Associar e Mesclar.
Consulte tambm Arquivo de vrias bobinas na pgina 364.
Arquivo secundrio
O segundo arquivo que voc abre quando h dois arquivos abertos ao mesmo tempo.
Voc s pode abrir ou configurar um arquivo secundrio de cada vez. Um arquivo
primrio e um secundrio so usados em operaes Associar e Mesclar. O arquivo
secundrio o segundo arquivo usado em operaes Associar e Mesclar.
Consulte tambm Arquivo primrio na pgina 365.
Arquivo seqencial
Um arquivo de dados (tal como um arquivo de fita) cujos registros devem ser acessados
em uma ordem fixa, um aps o outro.
Arquivo tipo bucketed
No ACL, um arquivo cujos registros contm blocos repetidos de campos de estrutura e
tamanho semelhantes. Cada bloco denominado um bucket.
ASCII
Sigla de American Standard Code for Information Interchange. ASCII o conjunto de
caracteres mais comum usado para facilitar a troca de dados e a comunicao entre
microcomputadores.
Consulte tambm EBCDIC na pgina 369.
366
Manual de Referncia
Associao de arquivos
Um processo que combina os dados de transao com os registros do arquivo de
cadastro, ou compara o contedo dos campos de dois arquivos. O comando Associar do
ACL permite a combinao dos campos de dois arquivos com estruturas diferentes em
um terceiro arquivo e tambm pode identificar registros correspondentes ou
no-correspondentes em um, ou em ambos os arquivos.
AVERAGEn
Uma varivel especial do ACL criada automaticamente por comandos especficos, tal
como o comando Estatsticas, que contm o valor mdio do campo em que o comando
foi emitido pela ltima vez.
Batch
Uma seqncia de comandos do ACL definidos e armazenados em um Projeto. Voc
pode criar um batch a ser executado repetida e automaticamente, ou para solicitar informaes do usurio.
Batch interativo
Um batch que solicita informaes do usurio enquanto est sendo executado.
Consulte tambm Batch na pgina 366.
Buffer
Espao de armazenamento temporrio para dados que esto sendo transmitidos de um
componente de computador para outro. Um buffer compensa as diferenas de
velocidade em que os componentes podem processar os dados que esto sendo roteados
para eles.
Cadeia de caracteres
Uma seqncia de caracteres.
Campo
Unidades individuais de informao que formam um registro em um arquivo. Um
registro pode ter diversos campos. Cada campo possui um nome para referncia.
Consulte tambm Registro na pgina 374.
Campo calculado
Uma expresso algbrica definida que usa os resultados de clculo ou um comando do
ACL para criar dados adicionais.
O campo calculado s existe na definio de arquivo de entrada e no realmente uma
parte do arquivo de dados. Trata-se de um campo virtual que permite a realizao de
Apndice C
Glossrio
367
clculos com base em informaes do arquivo de dados sem afetar ou alterar os dados
originais. possvel tratar um campo calculado como um campo fsico real.
Consulte tambm Campo fsico na pgina 367.
Campo-chave
Um campo de ordenao. Quando se ordena um arquivo, o campo-chave o campo que
voc informa ao ACL para usar na criao da seqncia de ordenao.
Campo condicional
Um campo cujo valor depende de uma condio.
Consulte tambm Campos condicionais calculados na pgina 164 do Guia do Usurio
do ACL para Windows e Campos condicionais estticos na pgina 176 do
Campo fsico
Ao contrrio de um campo virtual ou calculado, um campo fsico se refere a dados que
existem diretamente no arquivo de dados.
Consulte tambm Campo calculado na pgina 366.
Campo ou coluna de quebra
Um campo ou coluna-chave de ordenao que o ACL usa para imprimir automaticamente uma linha de subtotal em um relatrio, sempre que o contedo do campo ou da
coluna for alterado.
Campo sobreposto
A parte de um campo j definido que redefinida como um campo diferente.
Campo virtual
Consulte Campo calculado na pgina 366.
Campos/expresses ad hoc
Uma expresso ou campo no-definido usado para clculos temporrios que no
salvo como parte de uma definio de arquivo de entrada.
Consulte tambm Expresso na pgina 370.
Caractere
Uma letra, dgito ou outro smbolo utilizado para representar dados. Os dados tipo
caractere so normalmente utilizados para representar seqncias de texto ou informaes sobre data.
368
Manual de Referncia
Condio
Um teste que retorna um valor verdadeiro ou falso.
Constantes
Qualquer valor de data, numrico, de cadeia ou lgico que no se altera quando o ACL
processa um registro.
Contaminao
Em amostragem, o valor do erro referente a um item especfico.
COUNTn
como o comando Estatsticas. COUNTn contm o nmero de registros do arquivo, em
que esse comando foi emitido pela ltima vez.
Dados imprprios
Dados que so tecnicamente vlidos, mas no corretos. Por exemplo, valores negativos
em um campo numrico que deve conter apenas valores positivos.
Dados incompletos
Dados que contm falhas ou que no esto na seqncia correta.
Dados inconsistentes
Dados aos quais no existem dados correspondentes ou comparveis em outro campo
ou arquivo.
Dados invlidos
Os dados em um campo que no correspondem ao tipo de campo atribudo a esse
campo.
Definio de campo
Uma definio de campo identifica e descreve o formato dos dados em um arquivo. Os
arquivos eletrnicos podem conter muitos campos para o mesmo registro. Geralmente,
cada registro em um arquivo contm os mesmos campos.
Definio de arquivo de entrada
Descreve a estrutura, o contedo e o layout de um arquivo de dados e vincula o arquivo
de dados ao Projeto. Inclui informaes como nomes de campo, definies de campo e
tipos de campo. O ACL fornece automaticamente a voc algumas dessas informaes,
tais como tipo de arquivo, tipo de caractere, tipo de mdia, nmero de registros e
comprimento de registro. Uma definio de arquivo de entrada s definida e criada
uma vez para um determinado arquivo de dados.
Apndice C
Glossrio
369
EBCDIC
Uma sigla de Extended Binary Coded Decimal Interchange Code. Um conjunto de
caracteres usado principalmente por minicomputadores e mainframes da IBM em
oposio ao conjunto de caracteres ASCII usado pela maioria dos microcomputadores.
Consulte tambm ASCII na pgina 365.
Else
Um comando do ACL que voc pode usar em comandos Grupo para fornecer um
mtodo alternativo de processamento se todos os testes anteriores forem falsos. Else s
pode ser usado em um Grupo, nunca sozinho.
End
Um comando do ACL que fecha ou finaliza comandos Grupo. End s pode ser usado em
um Grupo, nunca sozinho.
Enquanto
Um parmetro de escopo que termina o processamento de um arquivo assim que o teste
associado falha. til na limitao do escopo de comandos que, caso contrrio, processariam o arquivo inteiro.
Consulte tambm Parmetro de escopo na pgina 373.
Espao em branco
A rea em branco em torno do texto. O ACL usa o espao em branco disponvel em um
relatrio para assegurar que os seus dados sero exibidos completamente.
Esttico
Este termo se refere a um registro cujos valores de campo voc no deseja alterar para
todos os registros relacionados. O modificador esttico geralmente usado junto com
arquivos de vrios tipos de registros em que os valores em um registro se relacionam
com os registros subseqentes.
Exibio
A exibio de dados em um arquivo, de acordo com a forma em que voc definiu os
campos do arquivo. Uma exibio do ACL no contm dados. Trata-se apenas de uma
organizao ou apresentao dos dados na tela.
Exibio padro
Uma exibio que mostra campos de dados definidos na ordem em que aparecem no
arquivo de dados.
370
Manual de Referncia
possvel alterar a ordem na Exibio padro. No entanto, se voc salvar as alteraes,

a exibio modificada ser a exibio padro na prxima vez em que os Projetos forem
abertos.
Expresso
Um conjunto de operadores e valores usados para executar clculos, especificar
condies para um teste ou criar valores que no existem diretamente nos dados. Uma
expresso do ACL pode ser uma combinao de campos de dados ou campos calculados, operadores, constantes, funes e variveis. As expresses definidas so salvas
como parte da definio de arquivo de entrada e, conseqentemente, como parte do
Projeto. Expresses especficas, no-definidas, s podem ser usadas para um nico
clculo e no so salvas como parte da definio de arquivo de entrada.
Consulte tambm Campo calculado na pgina 366, Extrair na pgina 370, Filtro
na pgina 370, Filtro global na pgina 370 e Filtro local na pgina 370.
Extrair
O processo de criar um subconjunto de um arquivo que contm alguns ou todos os
registros ou campos de um arquivo de entrada.
Filtro
Uma expresso que seleciona registros baseando-se no fato de um teste ou condio ser
ou no verdadeiro. Um filtro na verdade um tipo de expresso. Um filtro tambm
conhecido como um tipo lgico.
Consulte tambm Filtro global na pgina 370 e Filtro local na pgina 370.
Filtro global
Um filtro que se aplica a todos os comandos e exibies de um arquivo de entrada
inteiro. Um filtro global permanece ativo at que seja removido.
Consulte tambm Filtro na pgina 370.
Filtro local
Uma expresso que limita os registros processados queles que correspondem a uma
determinada condio lgica. Por exemplo, voc pode criar um filtro local para
focalizar uma parte do arquivo ou um tipo de transao especfico.
Consulte tambm Filtro na pgina 370 e Filtro global na pgina 370.
Fim do arquivo
Abreviado como EOF. Indica o fim de um conjunto de dados. Como um parmetro,
EOF faz o comando ser executado uma vez mais depois que o fim do arquivo
alcanado.
Apndice C
Glossrio
371
Funes
Uma rotina que aceita zero ou mais parmetros realiza um clculo e retorna um valor.
GAPDUPn
Uma varivel especial do ACL criada automaticamente por comandos especficos do
ACL, tais como os comandos Sequence, Gaps ou Duplicates, que contm o nmero de
falhas e/ou duplicidades no arquivo em que o comando foi emitido pela ltima vez.
Grupo
Uma seqncia de comandos que processada como uma unidade em uma passagem
nica por um arquivo. Voc pode criar um grupo em um batch, em seguida, processar o
batch para executar os comandos do grupo. O uso de grupos aumenta a velocidade de
processamento, j que o ACL executa todos os comandos de grupo em uma nica
passagem pelo arquivo, em oposio a uma passagem do arquivo para cada comando.
Grupo aninhado
Um grupo de comandos incorporados em outro grupo de comandos. O aninhamento
de grupos aumenta a fora do grupo permitindo o controle em relao a quais
comandos sero executados para qual registro.
Consulte tambm Grupo na pgina 371.
HIGHn
como Estatsticas, que contm os cinco valores mais altos (como padro) do campo em
que o comando foi emitido pela ltima vez.
Histograma
Um grfico de barras horizontais criado por meio do comando Histograma do ACL. Os
histogramas mostram a distribuio de valores em um campo ou expresso. Um histograma o equivalente grfico da estratificao de dados.
Histrico
Um Log especfico de arquivo que registra os comandos e a origem dos dados que voc
usa. O histrico adicionado definio de arquivo de entrada sempre que o ACL cria
um arquivo de dados como sada. O ACL grava a data e a hora de todos os comandos em
um arquivo de histrico. Vrias preferncias das Opes de impresso permitem a
impresso de um histrico de arquivo e outras informaes ao imprimir um relatrio ou
uma exibio.
Consulte tambm HIGHn na pgina 371.
372
Manual de Referncia
Histrico do arquivo
Um registro do processo usado quando o ACL cria um arquivo de dados como sada. O
histrico do arquivo inclui cada etapa usada na criao do arquivo, junto com um
registro de data e hora. O ACL tambm indica o nmero de registros no arquivo de
sada, o nome do arquivo a partir do qual a sada foi criada e o nmero dos registros
desse arquivo.
Consulte tambm Histrico na pgina 371.
If
Um parmetro de escopo que seleciona apenas alguns registros do arquivo, ou limita a
execuo de comandos do ACL. Por exemplo, COUNT IF AMOUNT > 0.
Tambm um comando que realiza uma ao se uma condio verdadeira, tal como:
IF TOTAL>1000000.
ndice
Um mtodo de seqenciamento de dados. O comando ACL Index tambm cria um
arquivo de ndice. Este arquivo contm ponteiros que permitem ao ACL ler dados na na
seqncia de ordenao, mesmo que os registros do arquivo de entrada original no
estejam ordenados. O processo de criao de um arquivo de ndice chama-se
indexao.
Log de comando
Um Log eletrnico que registra cada comando emitido e seus resultados, a partir do
momento em que voc abre um Projeto ACL at que ele seja fechado. As informaes do
Log so cumulativas. Voc pode visualizar, adicionar comentrios, imprimir ou limpar
o Log.
LOWn
como o comando Estatsticas, que contm os cinco valores mais baixos (como padro)
do campo em que o comando foi emitido pela ltima vez.
MAXn
como o comando Estatsticas, que contm o valor mais alto do campo em que o
comando foi emitido pela ltima vez.
Mesclar
Um processo que combina dois arquivos ordenados com uma estrutura de registro
idntica em um terceiro arquivo. Por exemplo, voc pode mesclar arquivos estruturados
Apndice C
Glossrio
373
identicamente de dois perodos de tempo diferentes ou de duas filiais da empresa em um

novo arquivo.
Consulte Anexar na pgina 363.
MINn
como o comando Estatsticas, que contm o valor mais baixo do campo em que o
MLEn
como o comando Avaliar, que contm o erro mais provvel do arquivo em que o
Nvel de materialidade
Em amostragem, o mximo valor monetrio extrapolado que aceitvel para confirmar
uma hiptese.
Operadores
Smbolos matemticos e lgicos utilizados no desenvolvimento de expresses. Entre os
operadores do ACL se incluem:
()
<
NOT
>
AND
^
=
&
*
>=
OR
/
<=
|
+
<>
Consulte tambm Expresso na pgina 370.

Origem
O valor inicial para a seqncia de nmeros aleatrios que o ACL gera quando so
necessrios nmeros aleatrios. Cada valor de origem exclusivo resulta em uma
seqncia diferente de nmeros aleatrios gerados, mas cada seqncia pode ser gerada
novamente a partir de sua origem.
Origem aleatria
O valor inicial para a amostragem por registro aleatrio.
Consulte tambm Amostragem por registro na pgina 363.
Parmetro de escopo
Uma declarao que pode ser includa em um comando do ACL para limitar o quanto
de um arquivo deve ser processado, ou para limitar a execuo de um comando ou
374
Manual de Referncia
batch. Exemplos: If, While, Next e First. Os parmetros de escopo podem ser usados
separadamente ou em conjunto.
Perodo
O nmero de dias entre duas datas especficas. Voc pode calcular o tempo transcorrido
desde uma transao subtraindo uma data de outra.
Primeiros
Um parmetro de escopo que seleciona um nmero especificado de registros,
comeando pelo primeiro registro do arquivo.
Projeto ACL
Um arquivo que contm todas as definies de arquivo do ACL (exibies, relatrios,
reas de trabalho e batches). O arquivo que contm os dados a serem analisados no faz
parte do Projeto, mas vinculado ao mesmo por meio da definio de arquivo de
entrada.
O nome de arquivo do Projeto utiliza a extenso .acl, que tambm atribuda aos
Projetos temporrios.
Consulte tambm Definio de arquivo de entrada na pgina 368.
Prximo
Um parmetro de escopo que faz o comando atual ser aplicado a apenas uma parte
subseqente do arquivo primrio.
RANGEn
como o comando Estatsticas, que contm a diferena entre as variveis MAXn e MINn.
Ela fornece o intervalo entre o valor mais alto e o valor mais baixo.
Registro
Uma unidade de itens de informaes relacionados que compe um arquivo. Cada
registro contm partes individuais de informaes chamadas de campos.
Consulte tambm Campo na pgina 366.
Rgua
A rgua do ACL usada como um guia para a definio de campos, j que marca a
posio de byte de cada campo no arquivo de dados.
Apndice C
Glossrio
375
SAMPINTn
como o comando Tamanho, que contm o intervalo de amostra baseado em dados
fornecidos ao comando.
SAMPSIZEn
como o comando Tamanho, que contm o tamanho da amostra baseado nos dados
fornecidos ao comando.
Tipos de campo
Os tipos de dados que o ACL pode ler. Como os tipos de dados normalmente se aplicam
aos campos dos registros de dados de entrada, eles so comumente chamados de tipos
de campo.
O ACL suporta a maioria dos tipos de campo, incluindo aqueles encontrados em aplicativos especficos, tal como o tipo de campo numrico encontrado no sistema de contabilidade ACCPAC.
Tipos de dados
Consulte Tipos de campo na pgina 375.
UELn
como o comando Avaliar, que contm o limite de erro superior do conjunto de dados
em que o comando foi emitido pela ltima vez.
Variveis
Os valores temporrios que existem na memria, no mximo, durante uma sesso do
ACL. As variveis podem ser usadas para reter e carregar informaes de um comando
do ACL para outro. A nica exceo uma varivel cujo nome se inicia com um sublinhado (_). Essas variveis so armazenadas como parte de seu Projeto.
Alguns comandos criam variveis automaticamente quando so executados. possvel
usar as variveis geradas pelo ACL, ou as variveis que voc cria, ao processar outros
comandos do ACL. Uma varivel preserva seu valor at voc alter-la ou sair do ACL.
Varivel ABSn
como o comando Estatsticas, que contm o valor absoluto do campo em que o
376
Manual de Referncia
WRITEn
Uma varivel especial ACL criada automaticamente por comandos especficos do ACL,
como Seqncia, Falhas ou Duplicidades, contm erros de seqncia de dados encontrados; at o nmero mximo especificado em suas preferncias.
377
ndice Remissivo
A
A esquerda, zeros, filtrar da
cadeia 55
Abrir 240
Abrir arquivos criados por
comandos 107
Abrir arquivos de fita 242
Abrir, opo Comprimento do
Buffer 240
Abrir, palavra-chave
Relacionamentos 241, 268
Abrir, parmetro 107
Abrir, parmetro. Consulte tambm
Usar Arquivo de Sada
Accept 115
Aceitar 115
Acima 338
Activate 120
Acumular campos
Estratificar, comando 327
Perodo, comando 123
Resumir, comando 333
Age 123
Ajuda 203
Ajustar posio inicial do campo
utilizando OFFSET( ) 65
Aleatrio 249
Aleatrio, exibio de colunas 249
Aleatrio, intervalo 250
Aleatrio, intervalo, especificar 250
Aleatrio, Opes da caixa de
dilogo Amostra 285
Aleatrio, ordem de
classificao 250
Aleatrio, ponto de partida 250
Aleatrio, ponto de partida,
especificar 250
Aleatrio, somente nmeros
exclusivos 250
Aleatrios, nmeros, gerar 70, 249
Alinhar campos usando o comando
Deslocar Campos 191
All 91
Alterar variveis de cabealho 128
Amostra 278
Amostra, Opo Sem

repeties 284
Amostra, selecionar campos ou
expresses 285
Amostra, valores, determinar 245
Amostragem
confiabilidade, especificar no
comando Tamanho 311
erros, avaliar 176
fator de ajuste de preciso 178
mtodo de seleo aleatria 280
mtodo de seleo de clula 280
mtodo de seleo de intervalo
fixo 280
modo de comando, utilizar 289
tendncia 278
teste de compatibilidade 278
teste de exposio 278
teste de superavaliao 279
teste substantivo 279
Amostragem de registros, comando
Tamanho, especificar 313
Amostragem por registro
comando Tamanho,
especificar 311
determinando os tamanhos da
amostra 311
Amostragem por unidade
monetria
campos, selecionar 285
tendncia de seleo 279
tipo, especificar 311, 312
Amostras, regenerar 280
Anlise digital, com comando
Benford 130
Anexar sada a um arquivo
existente 92
Ano, alterando padro do sculo 11
Anos de dois dgitos, alterando
padro 11
Anualidades, calcular valor
futuro 49
Aplicativos em idioma estrangeiro,
personalizar tipos de campos 10
Append 92
reas de trabalho
ativar 120
definidas 290
excluir no modo de
comando 150
salvar 290
Aritmtica de ponto fixo, no
comando Calcular 134
Arquivo filho, selecionar na caixa de
dilogo Relacionamentos 261
Arquivos
abertos 166
abrindo no modo comando 240
abrir, mtodo arrastar e
soltar 261
fechar no modo comando 248
fita, definindo 361
histrico, exibir 194
indexados. Consulte o comando
Pesquisar
mesclar 234
nomear 104
ODBC, importar 210
OS/390 convertidos 351
pesquisa por tamanho 45
reduzir tamanho do arquivo antes
da classificao 186
relacionados, critrios para
escolha 256
relacionar, procedimento 261
renomear no modo de
comando 269
servidor, salvar na unidade
local 104
tamanho, localizar 45
Arquivos batch, convertidos do
OS/390 352
Arquivos de comprimento varivel
abrir no modo de comando 241
Arquivos de relatrio
convertidos do OS/390 353
Arquivos de servidores, restries
de associao 221
Arredondar para o prximo nmero
inteiro 77
378
ndice Remissivo
As 92
Ascendente, ordenao 319
Ascending 93
ASCII 8
ASCII, arquivos de comprimento
varivel, abrir no modo de
comando 241
ASCII, caracteres de byte 35
ASCII, convertendo em
EBCDIC 42
ASCII, exibir usando comando
Descarregar 172
ASCII, formatar, comando
Listar 229
ASCII, valor decimal
equivalente 36
ASCII, valor decimal, localizar 29
Aspas
Comando Localizar,
utilizao 196
invertidas, em expresses de
data 11
Associao
arquivos no modo de
comando 227
Associar 218
Associar arquivos,
procedimento 224
Associar nomear arquivos 221
Associar registros correspondentes,
todas opes secundrias 220
todos s opes primrias e
secundrias 220
todos opo primria 220
Associar registros no
correspondentes 220
Associar, comparado com
Mesclar 234
Associar, comparar com
Relacionamentos 218
Associar, opo de registros
correspondentes 220
Associar, opes de sada 219
Associar, opes Um para muitos
do IMS 221
Ativar 120
Ativar reas de trabalho 120
Ativar arquivos de ndice 213
Atribuir 128
Atualizar 252
boto, usar 253
Atualizar dados ODBC no modo do
comando 252
Avaliar 176
Avaliar, confiabilidade,
informar 179
Avaliar, intervalo 179
Avaliar, parmetro Erros 180
Avaliar, parmetro Nmero de
erros 180
Avisos, pausa em batches 244
B
Batches
caixas de dilogo personalizadas,
criar 151
campos calculados, definir 145
comando grupo, processar 198
condies, especificar 168
criar 167
excluir no modo de
comando 150
executar 167
fechar 248
filtros, configurar 306
ndices, abrir 307
pausa para exibir mensagens 244
relacionamentos temporrios,
definir 268
renomear 270
Batches interativos, caixas de
dilogo 151
Batches interativos, criao 115
Benford 130
Benford, dgitos, especificar nmero
mximo 131
Benford, freqncia de, localizar 47
Benford, registros com valor
zero 132
Benford, registros de valores iguais a
zero 131
Benford, sada em grfico 132
Benford, valores positivos e
negativos, separar 131
Binrio 9
Binary 9
Bits
deslocar para a esquerda ou

direita 77
extrair do byte usando MASK(
) 59
localizar cadeias 33
Blanks iniciais, localizar utilizando o
comando Encontrar 297
Boto Deslocar Campos, usar 192
Boto Extrair campos na caixa de
dilogo Amostra 284
Boto Histrico do arquivo 194
Boto Outros campos, comando
Resumir 334
Boto Renomear, utilizar 269
Boto Tamanho, caixa de dilogo
Amostra 285
Botes rdio, adicionar s caixas de
dilogo personalizadas 158
Break 94
Buscar 230
Buscar expresso, no comando
Pesquisar 293
Buscar. Consulte tambm Localizar
registro
Buscar. Consulte tambm Localizar
Se
Bytes
converter com BIT( ) 33
deslocar, usando o comando
Deslocar Campos 191
ignorar, no comando
Descarregar 170
localizando o dgito para a
metade especificada 41
representao de caractere,
localizar 35
C
Cabo de conexo, unidade da
fita 357
Cadeias
de caracteres, dividir em
segmentos 79
posio inicial de byte ,
localizar 82
Cadeias com caracteres,
encontrados em outras cadeias
com caracteres 30
Cadeias de caracteres
ndice Remissivo
contagem de ocorrncias 65
isolar subcadeias 81
Caixa de seleo Clula, na caixa de
dilogo Amostra 283
Caixas de dilogo
caixas de texto, criao 116
com mltiplas solicitaes,
criar 120
comandos Perodo em, em
Perodo 123
de solicitao, criar 118
estrutura utilizando interface
grfica 152
listas suspensas, criar 116
tipo de solicitao nica,
criar 118
tipo solicitaes mltiplas,
criar 120
Caixas de texto, criar em caixas de
dilogo 116
Caixas de verificao, adicionar s
caixas de dilogo
personalizadas 157
Calcular 134
Calcular valores do campo em
expresses 135
Calculate 134
Clculos
mltiplos 134
Campo
modificadores. Consulte
Parmetros de comando
Campos
Chave, critrio de seleo do
comando Associar 221
chave, duplicidade 174
criar no modo de comando 144
data em branco, encontrando 11
deslocar para alinhar 191
incluir cadeias de caracteres 52
nomes de substituio 92
numrica, estratificao 328
ordem da posio inicial,
exibir 192
relacionado, usar no Construtor
de Expresses 263
renomear no modo de
comando 269
tipos, identificar 48
Campos calculados
definies, armazenar 290

definir no modo de
comando 145
excluir no modo de
comando 149
incondicionais 145
resultados armazenados em
campos do ACL 8
valor padro de configurao 74
Campos compactados
cdigos de sculo 18
definindo cdigos de sculo 18
especificando decimais 18
modificando formato de data 18
reconhecendo informaes sobre
data 12
Campos de caracteres
descobrir comprimento 55
Campos de chave
converter utilizando funes 254
critrio de seleo, comando
Associar 221
definio 254
formatao idntica, criar 74
indexar 256
normalizar 255
preparar para associar 221
relacionamentos,
caractersticas 254
Campos de data, encontrando em
branco 11
Campos numricos
estratificar 328
exibir totais 339
pontuao 17
resumo de perfis 245
Campos numricos compactados,
formatao de data 12
Campos numricos comprimidos,
especificando formatos de
data 12
Caracteres
incluir cadeia especificada 52
indesejveis, remover da
cadeia 73
inserir em cadeias 52
invlidos, localizar e
substituir 37
inverter a ordem na cadeia 76
isolar nmero especificado do
379
final da cadeia 54
localizados em um registro 46
Caracteres imprimveis,
EBCDIC 15
Caracteres no-imprimveis,
localizar 36
Caracteres que no podem ser
impressos, verificando 29
Casas decimais, alterando
nmero 40
Categorias de dados 5
Classificar 136
Classificar, alternativa para
Ordenar 319
Classificar, execuo
automtica 136
Classificar, sada 137
Classificar. Consulte tambm
Resumir
Classify 136
Cliente/Servidor
arquivos relacionados 254
exportar arquivos 184
salvar arquivos na unidade
local 104
Close 140
COBOL
clusula OCCURS, ajustar
posio inicial 65
tipo de campo
computational-3 18
tipo de campo em campos
binrios 9
Cdigos de sculo
alterando campos de data
compactados 18
alterando padro 11
modificando o formato de
data 19
Comando
sada, salvar em um arquivo 98
Comandos
executar mais uma vez no fim do
arquivo 96
fechar loops 233
grupo, fechar 200
grupo, indentar 200
histrico, exibir 194
processar grupos 198
registrar, Definir Eco 305
380
ndice Remissivo
usados, exibir 194

Comentrio 141
Comentrios
inserir no log de comando 141
Comment 141
Compactado 18
Comparao Exata de Caractere,
usando com BETWEEN( ) 32
Comparaes Exatas de Caractere,
efeito no comando Localizar 196
Comparar
cadeias com caracteres 32
cadeias usando MAP( ) 58
cadeias, usando MAP( ) 58
expresses ou valores de
campo 60
expresses, usando MATCH 60
similaridade fontica 79
Comprimento
do campo de caracteres,
descobrir 55
do registro, obter 71
Comprimento do Buffer, especificar
no modo de comando 240
Condio
especificar usando comando
Se 210
specificar usando o parmetro
Enquanto 112
Condicionais
arquivos de ndice, criar 213
grupos, criar 200
Condicional
campo calculado, definir no
modo de comando 145
Confiabilidade
Caixa de dilogo Avaliar,
informar 179
comando Tamanho,
especificar 311
Construtor de Dilogos
botes de rdio, adicionar s
caixas de dilogo 158
caixas de edio, adicionar s
caixas de verificao, adicionar s
controles, adicionar s caixas de
dilogo 155
controles, editar 162
listas dropdown, adicionar s

mensagens de texto, adicionar s
Construtor de Expresses
listas de itens do projeto,
adicionar s caixas de
dilogo 160
Contagem ocorrncias de cadeias de
caracteres 65
Contar 143
Contar registros usando o comando
Classificar 136
Contar registros utilizando
Estratificar 326
Controlar totais, produzir
utilizando o comando Total 338
Controles, nas caixas de dilogo
personalizadas
adicionar 155
editar 162
excluir 162
Conveno de formatao de data
ISO 14
Converso
de numrico para formato
zonado 87
utilitrio, ACL 347
Converses de funo, resumo 23
Converses iniciais de
maisculo/minsculo 68
Convertendo
datas em cadeia de caracteres 39
de ASCII em EBCDIC 42
valores de caractere em datas 38
valores numricos em datas 38
Converter
Dados do OS/390 para o Projeto
ACL 347
do formato caractere para
numrico 86
numrico no formato de
caractere 80
Copiar arquivos usando o comando
Extrair 186
Copiar dados
Consulte comando Exportar
Consulte o comando Extrair
Correspondncia, itens fonticos
similares 78
Count 143
Custom
tipo de campo, descrito 10
tipo de campo, utilizando em
aplicativos de idioma
estrangeiro 10
D
Dados
alinhados por byte, tipos de
campo a serem utilizados 15
bidirecionais, inverter a ordem de
exibio 84
caractere, descrito 5
categorias 5
data, caractersticas 5
de ponto flutuante IBM 16
fita, obtendo 357
lgicos, caractersticas 5
numrico, descrito 5
tipos de campos, equivalentes ao
ACL 7
Dados numricos
converter para formato sem
sinal 85
criar em formato compactado 66
em campos de caracteres 5
Tipo de campo BASIC 9
Dados numricos compactados
criar utilizando PACKED( ) 66
informaes sobre data 12
Data 11
comparaes, utilizar o comando
Perodo 124
constantes, usando nas
funes 28
exibir no modo de comando 167
retornos de valores negativos 28
Data piv, definida 11
Datas
americanas, convenes de
formatao 14
aspas, entre 11
Convenes de formatao
europia 14
Convenes de formatao
ISO 14
dia da semana, localizar 36
europias, conveno de
ndice Remissivo
formatao 14
formatando em campos
numricos comprimidos 12
julianas, conveno de
formatao 14
pesquisando intervalos 32
seriais, converter utilizando
funes 12
tipo serial 12
Date
dados armazenados como dados
de caractere 5
dados armazenados como dados
numricos 5
dados, caractersticas 5
formatos 13
formatos, definindo em campos
compactados 18
formatos, modificando o cdigo
de sculo 19
dBASE
arquivos, abrir no modo do
comando 241
formato, dados ACL 183
Decimais
caractere ASCII equivalente 36
especificando em campos
compactados 18
implcito, em campos
numricos 17
Define Field 144
Define Report 148
Definio do arquivo de entrada
excluir no modo de
comando 150
Definio Exata, usando com
BETWEEN( ) 32
Definies de campo
armazenar nos arquivos da rea
de trabalho 290
Definies do arquivo de entrada
campos, adicionar no modo de
comando 144
Definir 303
Definir campo 144
Definir filtro 306
Definir histrico 306
Definir ndice 307
Definir perodo 123
Definir relacionamentos. Consulte

Relacionamentos
Definir relatrio 148
Definir, equivalentes de
preferncias 304
Definir, opes 304
Delete 149
Descarregar 170
Descarregar, ignorar bytes 170
Descarregar, largura da coluna
exibida, alterar 171
Descarregar, parmetro
Atualizar 172
Descarregar, parmetro
Localizar 171
Descendente
modificador de campo 95
ordenao 319
padro, alterar 95
Descending 95
Desfazer a digitao na janela
batch 167
Deslocar Campos 191
Deslocar campos no modo de
comando 193
Deslocar Campos, colunas 191
Desvio padro
especificar no comando
Estatsticas 323
localizar 322
Dia da semana
convertendo em dgitos 42
localizar para a data
especificada 36
Dialog 151
Dilogo 151
Dilogo, usar para criar caixas de
dilogo 152
Dgitos
dgitos anteriores ( esquerda),
especificando no comando
Benford 131
localizando combinaes
especficas 47
representando o dia da
semana 42
Display 165
Distribuio binomial, comparada a
Poisson 310
Distribuio de Poisson
381
avaliao de amostragem
monetria 178
tamanho da amostra, vantagens
de utilizar 310
Diviso, localizar resto 63
Do Batch 167
Documentar sesses do ACL 141
Dump 170
Duplicao de registros, remover do
arquivo. Consulte o comando
Resumir
Duplicadas, entradas, localizar 78
Duplicates 174
Duplicidade, campos-chave,
localizar 174
Duplicidades 174
Duplicidades, testar no comando
Seqncia 299
Duplicidades. Consulte tambm
Seqncia
E
EBCDIC 15
EBCDIC, caracteres imprimveis 15
EBCDIC, convertido de ASCII 42
EBCDIC, exibir usando comando
Descarregar 172
Else 175
Em branco
em campos de data 11
E-mail, enviar utilizando
Notificar 238
Emprstimo, perodos de
reembolso, calcular 64
Emprstimos
calcular pagamento mensal 67
calcular valor presente 68
Encontrar 297
Encontrar. Consulte tambm a
opo Buscar expresso do
comando Pesquisar
End 176
End of File 96
Enquanto
parmetro, utilizao 112
utilizao com o parmetro
Primeiros 99
Enviar e-mail utilizando
Notificar 237
382
ndice Remissivo
EOF. Consulte o parmetro Final de

arquivo
Erros de seqncia, localizar 298
Erros mais provveis, amostragem
por unidade monetria 178
Erros, informar no comando
Avaliar 180
Espaos em branco
esquerda, remover da cadeia 57
arquivos relacionados 254
em campos numricos 17
inserir em cadeias 52
localizar nos campos 53
no final, remover 84
removidos com ALLTRIM( ) 29
valores repetidos 106
valores zero 106
Estatsticas 322
Estatsticas, campos e expresso,
selecionar 323
Estatsticas, desvio padro,
especificar 323
Estatsticas, executar
automaticamente 322
Estatsticas, valores maiores e
menores, nmero para
manter 323
Estatsticas-Z 130
Estratificar 326
Estratificar, acumular campos 327
Estratificar, executar
automaticamente 326
Estratificar, intervalos 327
Estratificar, livre, pontos de partida
e final do intervalo 327
Estratificar, sada 331
Estratificar, valor do intervalo
mximo 327
Estratificar, valor do intervalo
mnimo 327
Estratificar, valores,
determinar 245
Evaluate 176
Excluir 149
Excluir campos calculados no modo
de comando 149
Excluir histrico 150
Excluir relacionamentos 266, 268
Excluir totais especificados 110
Excluir, opo Tudo 150
Excluir. opo OK 150

Execuo automtica
Classificar, comando 136
comando Seqncia 298
Estatsticas, comando 322
Estratificar, comando 326
Total, comando 338
Verificar, comando 341
Executar batch 167
Executar batch, usar em grupos 167
Executar relatrio 170
Exibio, acessar usando comando
Definir Relatrio 148
Exibir 165
Exibir arquivos abertos no modo de
comando 166
Exibir data 167
Exibir histrico 166
Exibir primrios 166
Exibir secundrios 166
Export 183
Exportar 183
Exportar, Sistema Cliente/Servidor,
usar 184
Expresso numrica, convertendo
em data 38
Expresses
localizar usando o pesquisar 293
nomes de substituio 92
utilizando aspas invertidas 11
Extenses de nome de arquivo
.dbf 241
.fil 98, 240
.inx 241
.txt 98
Extract 186
Extrair 186
campos, caixa de dilogo
Exportar 188
campos, modo comando 190
Extrair registros, caixa de dilogo
Exportar 188
F
Falhas 197
Falhas, localizar em um dado 197
Falhas, testar, comando
Seqncia 299
Fechar 140
Fechar arquivos usando o comando

Sair 248
Fieldshift 191
Figura 107
File 98
File History 194
File Type 98
Filtrar, pontuao da cadeia 55
Filtro, palavra-chave do comando
Definir 306
Filtros
arquivos indexados 213
configurar em batches 306
Fim 176
Fim, usar em grupos 176
Find 195
First 99
Fita 336
Fita, acelerando o
rebobinamento 360
Fita, alternar entre fita e disco 360
Fita, arquivos, abrir 242
Fita, arquivos, acessar 336
Fita, arquivos, definindo 361
Fita, arquivos, indexar, associar e
mesclar 361
Fita, com rtulo, calcular marcas de
arquivo para saltar 338
Fita, dados, obtendo 357
Fita, palavra-chave Saltar 337
Fita, procedimentos de soluo de
problemas 362
Fita, rebobinar, utilizando o
comando Fita 338
Fita, sem rtulo, calcular marcas de
arquivo para ignorar 337
Fita, sistema da unidade,
aquisio 355
Fita, sistema da unidade,
componentes 356
Float 15
Footer 100
Formatao
consistncia 74
datas em campos numricos
comprimidos ou
compactados 12
datas em campos numricos,
sintaxe do comando 14
Formatando campos de data
ndice Remissivo
compactados 18
Formatar
datas ou campos numricos em
modo de comando 107
Formato
arquivos, convertidos do
OS/390 352
ASCII, exibir usando o comando
Descarregar 171
converter numrico em
caractere 80
EBCDIC, exibir usando comando
Descarregar 171
exibir usando comando
Listar 227
hexadecimal, exibir usando o
comando Descarregar 171
sada, especificar 98, 111
Formato de caractere
convertendo em data 38
converter de expresses
numricas 80
converter para numrico 86
Formato delimitado por vrgula,
dados do ACL 183
Formato do relatrio HTML,
especificar 272
Formato Excel, converter dados do
ACL para 183
Formato listar, exibir sada 227
Formato Lotus 1-2-3, dados do
ACL 183
Formato numrico, converter de
caractere 86
Formato SDF no delimitado,
criar 229
Formato Word, dados do ACL 183
Formato WordPerfect, dados do
ACL 183
Freqncia de limite de erro
superior, amostragem de
registros 176
Freqncia de ocorrncia, avaliar
usando estatstica Z 88
Funo ALLTRIM( ) 29
Funo BIT ( ) 33
Funo BYTE ( ) 35
Funo CDOW( ) 36
Funo CHR( ) 36
Funo CLEAN( )
comparada preferncia Dados

Invlidos em Branco 37
sobre 37
Funo CTOD ( ) 38
Funo DATE( ) 39
Funo DECIMALS( ) 40
Funo DIGIT( ) 41
Funo DOW( ) 42
Funo EBCDIC( ) 42
Funo EFFECTIVE( ) 43
Funo EXCLUDE( ) 44
Funo EXPONENT( ) 44
Funo FILESIZE( ) 45
Funo FIND( ) 46
Funo FREQUENCY( ) 47
Funo FTYPE( ) 48
Funo FVANNUITY( ) 49
Funo FVLUMPSUM( ) 50
Funo HEXADECIMAL( ) 51
Funo INCLUDE( ) 52
Funo INSERT( ) 52
Funo INTEGER( ) 53
Funo ISBLANK( ) 53
Funo LAST( ) 54
Funo LEADING( ) 55
Funo LENGHT( ) 55
Funo LOGARITHM( ) 56
Funo LOWER( ) 57
Funo LTRIM( ) 57
Funo MAP( ) 58
Funo MASK( ) 59
Funo MATCH( ) 60
Funo MAXIMUM( ) 61
Funo MINIMUM( ) 62
Funo MOD( ) 63
Funo NOMINAL( ) 63
Funo NPER( ) 64
Funo OCCURS( ) 65
Funo OFFSET( ) 65
Funo PACKED( ) 66
Funo PMT( ) 67
Funo PROPER( ) 68
Funo PVANNUITY( ) 68
Funo PVLUMPSUM( ) 69
Funo RAND( ) ou RND( ) 70
Funo RATE( ) 70
Funo RECLEN( ) 71
Funo RECNO( ) 72
Funo REMOVE( ) 73
Funo REPEAT() 74
383
Funo REPLACE( ) 74
Funo REVERSE( ) 76
Funo RJUSTIFY( ) 76
Funo ROOT( ) 76
Funo ROUND( ) 77
Funo SHIFT( ) 77
Funo SOUNDEX( ) 78
Funo SOUNDSLIKE( ) 79
Funo SPLIT( ) 79
Funo STRING( ) 80
Funo SUBSTRING( ) 81
Funo TEST( ) 82
Funo TIME( ) 82
Funo TRANSFORM( ) 84
Funo TRIM( ) 84
Funo UNSIGNED( ) 85
Funo UPPER( ) 85
Funo VALUE( ) 86
Funo VERIFY( ) 87
Funo ZONED( ) 87
Funo ZSTAT( ) 88
Funo( ) ABSOLUTE 28
Funo( ) AGE 28
Funo( ) ASCII 29
Funo( ) AT 30
Funo( ) BETWEEN 32
Funo( ) BLANKS 35
Funes
de converso, resumo 23
diversas, resumo 23
financeiras, resumo 23
lgicas, resumo 23
matemticas, resumo 23
normalizar campos de chave 255
visualizar categorias no
Construtor de Expresses 23
Funes diversas, resumo 23
Funes financeiras 23
Funes matemticas, resumo 23
G
Gaps 197
Grfico
Consulte tambm Histograma
Consulte tambm Parmetro Para
Grfico de sada do comando
Estratificar 331
Graph 100
Group 198
384
ndice Remissivo
Grupo 198
Grupos
aninhados, criar 202
Comando Executar Batch,
utilizao 167
condicionais, criar 200
fechar comandos 176, 200
indentar comandos 200
Loop, comando 232
repetir processamento 232
Seno, comando 175
simples, criar 200
Variveis 202
H
Header 101
Help 203
Hexadecimal
exibir, usando comando
Descarregar 172
valor equivalente, localizar 51
Histogram 203
Histograma 203
Histograma, colunas,
especificar 205
Histograma, parmetro
Intervalos 205
Histograma, pontos iniciais e finais,
especificar 205
Histograma, valores,
determinar 245
Histogramas, criao em modo de
comando 209
Histrico
arquivo, entradas mximas 306
arquivo, excluir 150
arquivo, exibir 194
palavra-chave do comando
Definir 306, 307
Histrico do arquivo 194
Histrico do arquivo, entradas
mximas, definir 306
Hora, obter atual 82
I
If 102, 210
Ignorar, palavra-chave do comando
Listar 228
Import 210
Importar 210
Importar tabelas ODBC 210
Impresso
ndices, lista de 256
no modo de comando 108, 170
Imprimir
IMS um para muitos, opo do
Index 211
Indexao
campos de chave,
Relacionamentos 256
comparada ordenao 212
no mod de comando 218
Indicadores de sinal,
hexadecimal 21
ndice 211
ndice, palavra-chave do comando
Definir 307
ndice. Consulte tambm Ordenar
ndices
abrir em batches 307
ativar 213
condicionais, criar 213
condicionais. Consulte o
comando Pesquisar
excluir no modo de
comando 150
filtros 213
ndices condicionais. Consulte o
comando Pesquisar
Informao ausente, localizar nos
campos 53
Informao invlida, substituir 74
Inicializao de variveis, funo
REPEAT( ) 74
Iniciar, opo da caixa de dilogo
Amostra 285
Incio, caixa de dilogo
Amostra 285
Inco da Data do Sculo 11
Inserir espaos em branco ou
caracteres em cadeias 52
Intervalo
Caixa de dilogo Amostra 284
Caixa de dilogo Avaliar 179
Intervalos de falha, informar,
comando Seqncia 300
Intervalos, caixa de dilogo

Estratificar 327
Intervalos, localizar utilizando o
comando Estatsticas 322
Intervalos, pontos de partida e final
na caixa de texto Livre 327
Invlidos
dados, encontrar usando o
comando Descarregar
(Dump) 170
dados, localizar utilizando o
comando Verificar 341
Inverter a ordem dos caracteres na
cadeia 76
Investimentos, clculo do valor
futuro 50
J
Join 218
Justificar, direita, utilizando a
funo RJUSTIFY 76
K
Key 103
L
Largura
coluna, alterar no comando
Descarregar 171
modificador de campo,
utilizao 114
padro, alterar 114
Limite
data, especificar no comando
Perodo 124
parmetro, caixa de dilogo
Amostra 283
Limite de erro
comando Verificar,
especificar 342
Seqncia, comando 299
Limite de erro superior, em
amostragem monetria 176
Limite, superior e inferior no
comando Benford 131
Linguagem IBM PC, tipo de campo
BASIC 9
ndice Remissivo
Linhas de detalhes, suprimir

utilizando o comando
Relatrio 273, 274
Linhas em branco, suprimir
utilizando o comando
Relatrio 273, 274
List 227
Listar 227
Listar campos, opo do comando
Seqncia 299
Listar, relatrio de linhas
mltiplas 228
Listas de itens do projeto, adicionar
s caixas de dilogo
personalizadas 160
Listas suspensas
adicionar s caixas de dilogo
personalizadas 159
criar utilizando o comando
Aceitar 115
Localizar 195
Localizar cadeias de caractere
utilizando Pesquisar 292
Localizar caracteres em um
registro 46
Localizar erros de seqncia 298
Localizar itens ausentes utilizando o
comando Seqncia 300
Localizar literal, no comando
Pesquisar 292
Localizar nmeros de registro 293
Localizar o maior de dois
nmeros 61
Localizar registro, opo do
comando Pesquisar 292
Localizar registros em arquivos
indexados 212
Localizar registros que atendam s
condies 292
Localizar Se, opo do comando
Pesquisar 292
Localizar, no comando
Descarregar 171
Locate 230
Log de comando
comentrios, inserir 141
sada do comando
Estratificar 331
Logical, tipo de campo 16
Lgicas
funes, resumo 23
Lgico
caractersticas de dados 5
Loop
caixa de dilogo, exibir 232
palavra-chave Fim 233
M
Maisculo, converter de minsculo
ou mistura 85
Maisculo/minsculo, mudar 57
Manual de Instruo do ACL para
Windows 1
Marcas de arquivo
calcular nmero para saltar 337
definio 336
Materialidade, especificar no
comando Tamanho 311
Mximo
defeito tolervel, definido 309
valor do intervalo,
Estratificar 327
Memria, encontrando a
quantidade disponvel para
uso 166
Mensagens
Converses OS/390 349
criar com o comando Pausa 244
Merge 234
Mesclar 234
palavra-chave Pr-ordenar 237
Mesclar, caixa de seleo
Pr-ordenar 235
Mesclar, chaves, especificar 234,
235
Mesclar, comparado com
Associar 234
Mesclar, pr-requisitos 234
Mtodo clicar e arrastar para abrir
arquivos 261
Minsculos, converter de caracteres
alfabticos 57
Mistura de maisculo/minsculo,
converso para minsculo 68
Mistura maisculo/minsculo,
converter em minsculo 57
Modificador de campo Suprimir,
utilizao 110
Modificador de de campo de figura,
385
utilizao 107
Modo de comando, formatar datas
ou campos numricos em 107
MUS (amostragem de unidade
monetria)
Consulte tambm Amostragem de
unidade monetria
na caixa de dilogo do comando
Amostra 284
N
Name 104
No-atribudo, tipo de dados,
utilizando para dados alinhados
por byte 15
Next 105
Nodups 106
Nome
arquivo, alterar no modo de
comando 269
campo, alterar no modo do
comando 269
parmetro, utilizao 104
Nome do Relacionamento, caixa de
dilogo Relacionamentos 260
Nome-da-exibio, sintaxe de
modo de comando 149
Normalizao de campos de dados
utilizando REMOVE( ) 73
Notificar 237
palavra-chave Senha 239
Notificar, aplicaes de e-mail da
Microsoft 238
Notificar, endereo, especificar 237
Notify 237
Nozeros 106
Numeric 17
Numrico
formato, converso para
zonado 87
tipos de dados 5
Nmeros aleatrios, gerar 70, 249
Nmeros de dos registros atuais,
obter 72
386
ndice Remissivo
arquivos de formato,
utilizando 352
arquivos de relatrios,
utilizando 353
dados, converter para Projeto do
ACL 347
mensagens de erro de
converso 350
mensagens informativas sobre
converso 349
usando arquivos convertidos 351
O
ODBC
atualizar dados 252
senhas, criar 243
senhas, importar tabelas 210
tabelas de banco de dados,
importar 210
Opes
atualizar, comando
Descarregar 172
Sem repeties, na
amostragem 284
Opes da caixa de dilogo Amostra
Aleatrio 285
Clula 283
Extrair campos 284
Iniciar 285
Incio 285
Intervalo 284
Intervalo Fixo 284
Limite 283
MUS 284
Ordem de seleo de
relatrio 285
Populao 284
Registro 285
Subamostra 286
Tamanho 285
Open 107, 240
Ordem de classificao
ascendente 93
Comando Aleatrio 250
crescente ou decrescente 319
especificar 317
Ordem de ordenao, arquivos
indexados 212
Ordem de seleo de relatrio, caixa
de dilogo Amostra 285
Ordem, exibir campo 192
Ordenar 317
Ordenar, campos de chaves ou
expresses, selecionar 319
Ordenar, classificar alternativa 319
Ordenar, Comparar com
indexao 317
Ordenar, ordem, especificar 319
Ordenar, requisitos de espao 319
Ordenar. Consulte tambm ndice
OS/390
arquivos batch, utilizando 352
P
Packed 18
Pagamento, calcular valor
mensal 67
Page 107
Pgina
caixa de dilogo de configurao,
exibir utilizando o comando
Relatrio 273, 274
modificador de campo,
descrio 107
quebras, inserir no modo de
comando 107
Parmetro
Anexar/Anexar a um Arquivo
Existente 92
Arquivo 98
ascendente 93
Cabealho 101
Cabealho, em comparao com
a varivel cabealho 101
Campos, comando Aceitar 116
Chave 103
Chave. Consulte tambm Quebra
Como 92
Fim de arquivo 96
Grfico 100
Imprimir, descrio 108
Local 104
Nodups 106
Nozeros 106
Para 111
Para. Consulte tambm Grfico
Para. Consulte tambm Imprimir
Para. Consulte tambm Nome
Para. Consulte tambm Tela
Primeiros 99
Prximo 105
Quebra 94
Registro, utilizao 108
Se 102
Se, usar com filtro global 102
Se, utilizao com o parmetro
Primeiros 99
Suprimir outros 110
Tela 109
Tipo de arquivo 98
Tudo 91
Parmetro de data NDATE,
descrio 14
parmetro Usar Arquivo de Sada
Consulte tambm Abrir
Parmetros de escopo, limitar
processamento de registros com
Prximo 105
Parmetros de escopo, specificar
condio usando Enquanto 112
Password 243
Pausa 244
Pause 244
Perfil 245
Perfil de campos no modo de
comando 248
Perodo 123
Perodo, acumular campos 123
Perodo, sada 124
Perodos de reembolso de
emprstimo, calcular 64
Personalizado 10
Pesquisando, intervalo de
valores 32
Pesquisar 291
no modo comando 296
Pesquisar campos de chave em
arquivos indexados 212
Pesquisar expresso. Consulte
Localizar literal
Pesquisar, localizar expresses 293
Pesquisar, localizar nmeros de
registro 292
Pesquisar, parmetro Localizar
literal 292
Pesquisar, parmetro Localizar
Se 292
Pesquisar, usar arquivos de
ndice 212
PIC. Consulte Figura
ndice Remissivo
Picture 107
PL/1
tipo de campo comparado ao
numrico compactados 18
tipo de campo em campos
binrios 9
Placa controladora, exigncias do
sistema de fita 357
Ponto flutuante 15
Pontuao em campos
numricos 17
Populao
Caixa de dilogo Amostra 284
comando Tamanho,
especificar 311
Posio inicial do campo, ajustar 65
Posicionar no incio do arquivo 338
Preciso, fator de ajuste na
amostragem monetria 178
Pr-ordenar, comando
Resumir 333
Print 108
Print tipo de campo
comparado a numrico 20
decimais, implcito 20
Profile 245
Q
Quebra
campos de, especificao 94
Consulte tambm o parmetro
Chave
de pgina, inserir no modo de
comando 107
Quit 248
R
Raiz quadrada, calcular 76
RAM, exibe a quantidade disponvel
para uso 166
Random 249
Realinhar dados usando o comando
Deslocar Campos 191
Rebobinar fita
acelerando a velocidade 360
utilizar o comando Fita 338
Record 108
Reduzir tamanho de arquivo antes
da classificao 186
Refresh 252
Regenerar
amostras 280
comandos usados 194
Registrar comandos utilizando
Definir Eco 305
Registro
comprimentos, obter 71
nmero, obter atual 72
Opes da caixa de dilogo
Amostra 285
Registros
condicional, localizar 292
contar utilizando o comando
Estatsticas 322
contar utilizando o comando
Estratificar 326
contar, critrio 143
duplicaes, remover do arquivo.
Consulte o comando Resumir
especfico, buscar 230
incluir campos indefinidos na
sada 108
limitar processamento com o
parmetro Prximo 105
localizar no modo de
comando 195
nmero, localizar 292, 293
primeiro, localizar utilizando o
comando Encontrar 297
Registros correspondentes
Opo do comando Associar 220
todos os primrios e todos os
secundrios, opo de
todos primrios, opo de
todos secundrios, opo de
Registros no correspondentes,
opo de comando Associar 220
Relacionados
arquivos, registros ausentes ou
duplicados 254
campos, adicionar tela 265
campos, usar no Construtor de
Expresses 263
Relacionamentos 253
Relacionamentos entre arquivos,
387
planejar 257
relacionamentos mltiplos,
criar 261
Relacionamentos temporrios,
definir 268
Relacionamentos temporrios,
estabelecer 268
Relacionamentos, arquivo filho,
selecionar 261
Relacionamentos, arquivo pai, caixa
de dilogo Relacionamentos 261
Relacionamentos, arquivos
Cliente/Servidor 254
Relacionamentos, caixa de texto
Nome do Relacionamento 261
Relacionamentos, campos chave,
criar formato idntico 74
Relacionamentos, campos de chave,
escolher 255
Relacionamentos, comparado com
Associar 218
Relacionamentos, definir 268
Relacionamentos, excluir 266, 268
Relacionamentos, exibir 268
Relacionamentos, fechar arquivos
usando o comando Close 140
Relacionamentos, muitos para
um 254
Relacionamentos. Consulte
Relacionamentos
Relacionar arquivos,
procedimento 261
Relaes Muitos para Um entre,
arquivos pai e filho 254
Relations 253
Relatrio 272
Relatrio, caixa de dilogo de
configurao de pgina 274
Relatrio, resumo dos totais e
subtotais 274
Relatrio, suprimir linhas de detalhe
em branco 274
Relatrios
com vrias linhas, criar 274
criar no modo de comando 277
etapas de formatao 272
excluir totais especificados 110
exibio da largura,
especificar 114
imprimir no modo de
388
ndice Remissivo
comando 170
visualizar 273
zeros, suprimir 277
Relatrios com vrias linhas,
criar 274
Removendo caracteres dos
campos 44
Rename 269
Renomear 269
Report 272
Requisitos de espao, comando
Ordenar 319
Resto de diviso, isolar 63
Resumir 332
Resumir, acumular campos e
expresses 333
Resumir, arquivos grandes, gerar
totais 332
Resumir, boto Outros campos 334
Resumir, campos adicionais,
especificar 334
Resumir, campos ou expresses,
selecionar 334
Resumir, pr-ordenar arquivos 333
Resumir, totais do valor do
campo 332
Resumir, usando o comando
Classificar 136
Resumir. Consulte tambm
Classificar
Rodaps
alterar variveis de rodap 128
comparao entre o parmetro
rodap e a varivel rodap 100
inserir nos relatrios 100
S
Sada
anexar a um arquivo existente 92
criar grficos 100
exibir em um grfico 100
exibir na tela 109
formato, especificar 98, 111
salvar em um arquivo
separado 98
Sair 248
Saltar, palavra-chave do comando
Fita 337
Salvar 290
Sample 278
Save 290
Screen 109
Se 102, 210
Search 291
Seek 297
Segmentar cadeias de caracteres 79
Sem sinal 22
Sem sinal, formato, converso de
dados numricos 85
Seno 175
Senha 243
Senha, comando Notificar 239
Senha, criar 243
Senha, ocultar 305
Senha, ODBC, importar tabelas 210
Sequence 298
Seqncia 298
Seqncia, campos, especificar 299
Seqncia, executar
automaticamente 298
Seqncia, intervalos de falhas,
relatrio 300
Seqncia, itens ausentes,
relacionar 300
Seqncia, nmero mximo de
erros, especificar 299
Seqncia, teste de
duplicidades 299
Seqncia, teste de falhas 299
Seqncia. Consulte tambm
Duplicidades
Seqncia. Consulte tambm Falhas
Set 303
Smbolos ASCII, acrescentar aos
campos, para formatao 36
Similaridades fonticas, localizar 79
Size 309
Soletrar, inconsistncias,
localizar 78
Solucionar problemas da fita 362
Soma total, calcular valor
presente 69
Sort 317
Statistics 322
Stratify 326
Subamostra, opo da caixa de
dilogo Amostra 286
Subcadeias, localizar em cadeias de
caracteres 81
Substituio comparada com
anexar 92
Subtotais, gerar com a opo de
quebra 94
Sumarizar 332
Summarize 332
Suppress 110
Suprimir
linhas de detalhes utilizando o
comando Relatrio 273, 274
linhas em branco utilizando o
comando Relatrio 273, 274
zeros nos relatrios 277
T
Tamanho 309
Tamanho da amostra
amostra do atributo, gerar 310
calculando no modo de
comando 317
determinar 309
distribuio de Poisson,
vantagens de utilizar 310
Tamanho, alterar 85
Tamanho, amostragem do registro,
especificar 311, 313
Tamanho, limite superior de erro,
especificar 311
Tamanho, materialidade,
especificar 311
Tamanho, populao,
especificar 311
Tamanho, taxa de erro prevista,
especificar 311
Tamanho, tipo de amostragem
monetria, especificar 311, 312
Tamanho, total de erros previsto,
especificar 311
Tape 336
Taxa de erro prevista, especificar no
comando Tamanho 311
Taxa de juros nominal, calcular 63
Taxa, calcular juros sobre a
anualidade 70
Taxas de juros
efetiva anual, calculando 43
nominal, calcular 63
sobre anualidade, calcular 70
ndice Remissivo
Tendncia, seleo de
amostragem 278
Teste Se em grupos, comando
Seno 175
Teste, criar usando comando
Se 210
Texto
formatar dados do ACL 183
mensagens, adicionar s caixas de
dilogo 156
Tipo de Amostra 279
Tipos de campos
ACCPAC 8
ACL 8
ACL, definido
automaticamente 8
ACL, e equivalentes de tipo de
dados comuns 7
BASIC 9
binrio 9
compactados 18
COMPUTATIONAL-1 em
campos binrios 9
custom 10
date, descrito 11
EBCDIC 15
float 15
halfbyte 15
IBMfloat 16
identificar 48
Logical 16
micro 17
numrico 17
PCASCII 20
Print 20
reconhecidos por ACL 6
sobre 6
sobrepor 144
Unisys 21
unsigned 22
utilizando campos calculados
para converter 6
utilizando funes para
converter 6
VAXfloat 22
zoned 22
Tipos de campos ACL, equivalentes
a tipos de dados comuns 7
Tipos de campos ACL, equivalentes
ao tipo dos dados fonte 7
To 111
Top 338
Total 338
Total de erros previsto, especificar
no comando Tamanho 311
Total, campos numricos e
expresses, exibir 339
Total, excluir fora do intervalo
especificado 110
Total, executar
automaticamente 338
Total, grupo, utilizar 338
Totalizar campos numricos no
modo de comando 341
Tudo, parmetro 91
U
Unidade local, salvar arquivos do
servidor 104
Unsigned, tipo de campo 22
Usar Arquivo de Sada 112
Use Output File 112
Utilitrio
ACL 347
software, sistema de fita 357
V
Validade
dados, testar utilizando o
dos dados, teste utilizando a
funo VERIFY 87
erros, localizar utilizando o
Valor absoluto
calculado utilizando a funo
ABSOLUTE( ) 28
localizar utilizando o comando
Estatsticas 322
Valor do intervalo mnimo,
comando Estratificar 327
Valor exponencial, localizar 44
Valor futuro
anualidade, calcular 49
investimento, calcular 50
Valor inteiro da expresso numrica
ou campo. 53
Valor logartmico, calcular 56
389
Valor presente
da soma total, calcular 69
dos emprstimos, calcular 68
Valores de campo, comparar
usando MATCH( ) 60
Valores maiores/menores,
comando Estatsticas 323
Valores repetidos, exibidos como
espaos em branco 106
Valores zero, exibir como espaos
em branco 106
Valores, calcular usando o comando
Calcular 134
Variveis
alterar valores 128
grupo de comandos, usar 202
nomes, substituir 128
resultados armazenados em
campos ACL 8
teste usando comando Se 210
valores, exibir no modo de
comando 166
Vencimento, usando as funes
para calcular 28
Verificar 341
Verificar, especificar campos ou
expresses 343
Verificar, executar
automaticamente 341
Verificar, limite de erro 342
Verify 341
Visualizar formato do relatrio 273
W
While 112
Width 114
Z
Zeros
esquerda, filtrar 55
arquivos relacionados,
origem 254
Zonado 22
Zonado formato, converso de
numrico 87
Zoned, tipo de campo 22
390
ndice Remissivo
Help Desk Global

Inside Back cover to go inside
Reference Manual and User Guide
As Amricas
+1-604-669-4997
+1-604-689-4209
support@acl.com
Europa, Oriente Mdio e frica

+32-2-642-22-90
+32-2-642-22-91
support_europe@acl.com
sia e Costa do Pacfico

+65-299-3350
+65-299-5110
support_asia@acl.com
ACL
Verso
7
Manual de Referncia
ACL Services Ltd.

1550 Alberni Street
Vancouver, BC, Canada V6G 1A5
Tel: +1-604-669-4225 Fax: +1-604-669-3557
E-mail: info@acl.com Web: www.acl.com
ACL Europe S.A.

Ringlaan 39 bus 3
1853 Strombeek-Bever, Belgium
Tel: +32-2-642-22-90 Fax: +32-2-642-22-91
E-mail: info_europe@acl.com Web: www.acl.com
AWDP107087
ACL
50 Kallang Avenue
#07-05 Noel Corporate Building
Singapore 339505
Tel: +65-299-3350 Fax: +65-299-5110
E-mail: info_asia@acl.com Web: www.acl.com
para Windows
ACL Services (Singapore) Pte. Ltd.
Manual de Referncia
ACL para Windows
Verso

ACL ManPt v7 - Manual - Completo

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ACL ManPt v7 - Manual - Completo

Uploaded by

Copyright:

Available Formats

ACL

ACL Services Ltd.

ACL Europe S.A.

ACL Services (Singapore) Pte. Ltd.

ACL para Windows

ACL para Windows

Copyright 2002 ACL Services Ltd.

Publicado em fevereiro de 2002 por:

Captulo 1: Tipos de campo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Print (Imprimir) ....................................................................................

Captulo 3: Parmetros de comandos comuns . . . . . . . . . . . . . . . . . 91

Captulo 4: Comandos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Sintaxe do modo de comando ...................................................... 142

Parmetros .................................................................................... 175

Grupos simples .............................................................................. 200

Sintaxe do modo de comando ...................................................... 231

Escolha dos campos-chave ............................................................ 255

Seek (Encontrar) .................................................................................. 297

Top (Acima) .......................................................................................... 338

Apndice A: Como usar o utilitrio ACL . . . . . . . . . . . . . . . . . . . . . 347

Apndice B: Trabalhar com fita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Apndice C: Glossrio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Sobre este manual

Tipos de campo do ACL

O Manual de Referncia do ACL para Windows oferecido para usurios licenciados do

Ler ou importar dados de arquivos de dados de fonte externa

Visualizar, analisar e reportar dados

Automatizar rotinas analticas personalizadas

O Guia do Usurio do ACL para Windows oferecido a usurios licenciados do ACL.

Livro de trabalho do ACL para Windows

ACL para Windows Verso 7

Convenes da sintaxe de comando

Indica sintaxe de comando usada na linha de comando ou em um

Indicam parmetros ou selees de comandos opcionais.

Incluem um conjunto de opes dentre as quais deve ser escolhida

Barras verticais separam opes.

Guia do Usurio do ACL para Windows

ACL para Windows Verso 7 Ajuda on-line

Livro de Trabalho do ACL para Windows

Se disponvel, o centro de suporte tcnico do ACL interno sua empresa

Sobre este manual

Centro de suporte on-line

Help desk global

Europa, Oriente Mdio e frica

sia e Costa do Pacfico

ACL para Windows Verso 7

ACL para Windows Verso 7

No h tipos de dados atribudos especificamente para representar datas e no h

Tipos de campos do ACL

Categorias de dados e tipos de campos do ACL

Tipo de campo do ACL

Tipo de campo do ACL

Dados de origem e tipos de campo do ACL

Tipos de dados de origem e tipos de campos do ACL

Tipo de campo do ACL

String (Cadeia) (BASIC)

Computational-1 (Computacional-1) (COBOL)

Computational-3 (Computacional-3) (COBOL)

PIC 999 (COBOL)

Fixed Binary (Binrio fixo) (PL/1)

ACL para Windows Verso 7

Tipo de dados fonte

Tipo de campo do ACL